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PREFACE 


This manual provides overall information on the Honeywell Series 6000 
Time-Sharing System. Included in this document are command definitions, 
time-sharing file descriptions, terminal operations, error message 


definitions, and service/utility subsystem descriptions. 


The Time-Sharing System described in this manual is also available 
the Honeywell Series 600 Information Processing System. 


The term GCOS, as used in this manual, was formerly GECOS,. In addition the 
following terms have been changed as indicated. 


New Term Old Term 
system Input GEIN 
File and Record Control GEFRC 
General Loader GELOAD 
GRTS GERTS 


on 


GCOS is a coded system designed to extend the power of Series 
600/6000 in the areas of program preparation and maintenance, 
Gata control, operations control, and utility functions. Ee 
supported by comprehensive documentation and training; periodic 
program maintenance and, where feasible, improvements are fur- 
nished for the current version of the system, provided it is not 


modified by the user. 
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SECTION I 


TIME-SHARING SYSTEM 


SYSTEM DESCRIPTION 


The Series 6000 Time-Sharing System operates under the direction of the 
Comprehensive Operating Supervisor (GCOS), and constitutes one dimension 
of an integrated, three-dimension Series 6000 Information Processing 
Systeml, Under GCOS (formerly GECOS), the three processing dimensions -- 
batch, remote-batch and time-sharing -- carry on their activities 
simultaneously, with intercommunication existing between the three 
processing dimensions. This intercommunication feature has considerable 
significance for the user of a time-sharing terminal. 


The Time-Sharing System (TSS) consists of a Time-Sharing Executive, a 
number of independent processing subsystems which operate under’ the 
Executive, and a common command language. The major subsystems of the 
Time-Sharing System include the following: 


e ABACUS -- A desk calculator facility featuring complex 
algebraic capabilities such as functions, summation 
Operations, and remembered variables. 


e BASIC -- An algebraic-language compiler/executor designed for 
the user with numerical calculations involving 
relatively small quantities of data. 


e CARDIN -- A facility for submitting a punch card format job 
at a time-sharing terminal for processing as a batch 
job. Job status iS available on request. The SCAN 
subsystem complements CARDIN by providing the 
Capability to scan the job output. 


e@e TEXT EDITOR (and RUNOFF) -- A facility for building, 
maintaining, and reformatting text files. 


e TSS ALGOL -- An ALGOL subsystem that gives the time-sharing 
user the capabilities of the ALGOL language. ALGOL is 
an international algorithmic language for computation, 
effective for stating a broad class of algorithms for 
numerical mathematics and for some logic processes. 


e TSS JOVIAL -- A JOVIAL subsystem that provides the 


time-sharing user with the capabilities of the JOVIAL 
language processor. 


lThe Time-Sharing System is also available on the Honeywell Series 600 
Information Processing Systen. 
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TSS FORTRAN -- An algebraic-language compiler/loader with 


extended capabilities for subprogramming, chain 
overlays, and peripheral P/O, Le provides the 
time-sharing users with batch programming capabilities. 

Series 6000 FORTRAN -- An algebraic-language compiler that 
combines the features of batch and time-sharing 
FORTRAN. 


The following subsystems provide service and utility functions for the 
Time-Sharing System: 


ACCESS -- is a file system manipulation subsystem that allows 
the user to create, delete, and modify file system 
catalogs, subcatalogs, and named files. The file space, 
not file content, iS manipulated with ACCESS. 


FDUMP -- is a remote-terminal, word-oriented file inspection 
and maintenance fac Lay LOL permanent files, 
regardless of their format. The files may have been 
generated in either batch, remote-batch, or 
time-sharing environments. 


File and Record Control (TSS) -- provides File and Record 
Control subroutines needed for Series 6000 FORTRAN, TSS 
ALGOL, and TSS JOVIAL. These subroutines may also be 
used in COBOL or may be called directly by programs 
written in GMAP. These subroutines also provide 
automatic functions for dealing with the variety of 
file and device types available on the system. 


FORTRAN TRANSLATOR -- permits the user to translate a 
Time-Sharing FORTRAN file into batch FORTRAN. The user 
may design and debug a program in Time-Sharing FORTRAN 
and then optimize its processing by converting it to 
batch FORTRAN. 


HELP -- permits a terminal user to obtain a detailed 
explanation of any system error message. 

JOUT -- provides a means for manipulating output from batch 
jobs. The batch job could be a CARDIN job with a 
disposition code of J or JOUT, a remote terminal batch 
job (GRTS), or a job submitted at the central site. 

Library Editor (LIBED) -- permits editing of Series 6000 


FORTRAN and Time-Sharing FORTRAN subroutine library 
files, such files to be subsequently processed by the 
Time-Sharing Library Generator (TSLG) program. 
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Library Generator (TSLG) -- permits a user to produce his own 


LODX 


Media 


RBUG 


SABT 


SCAN 


library file of Time-Sharing FORTRAN subroutines, 
complete with directory, ina form that is acceptable 
to the FORTRAN loader. 


-- permits a user to load a subsystem program from a 
permanent file into the Time-Sharing System LOL 
checkout. Thus, a thorough checkout of user-developed 
system software can be made before it is integrated 
into the command structure of the Time-Sharing System, 


Conversion Program -- is a batch-world program that may 
be run either at the central computer site or entered 
through a remote/batch terminal. It generates a 
standard format, time-sharing text file from a suitable 
card deck, or conversely, to produce a card deck from 
such a file. 


-- is a conversational debug routine that can be used 
in conjunction with CARDIN. RBUG has all of the 
capabilities of the DEBUG routine of the batch world, 
permitting the user to monitor execution of his 
program, insert and remove breakpoints, and alter 
contents of memory locations and registers dynamically; 
all in an interactive manner. 


-- retrieves specific locations of the ABRT file for 
printing at the user's terminal. The file named ABRT 
must have been created by the user and entered into his 
Available File Table (AFT). When the system aborts’ the 
user's program, the core storage area containing the 
program is written to the ABRT file. 


-- provides a means of examining output of a batch job 
from a time-sharing terminal; the batch job may have 
been submitted through CARDIN, remote-batch, or as 
standard-central-site job with its output placed into 
the file system. 


Terminal Debug Subroutine (TDS) -- permits the user to gain 


control of a time-sharing subsystem, during checkout, 
at selected locations within the subsystem. The user 
may then display and/or patch selected areas, display 
and/or modify registers, and either return to _ the 
subsystem normally or to a specified location within 
the subsystem. 
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The primary functions of the time-sharing command language are as 
follows: 


e Initiation of processing within a subsystem (e.g., LIST and RUN 
commands) 


e Storage, retrieval, and purge of permanent files (e.g., SAVE and 
OLD commands) 


e Request for operations on temporary time-sharing files (e.g., 
NEW and RESEQUENCE commands) 


e Request for pertinent operating information (e.g., HELP and 
STATUS commands) 


e Direction of flow of control within the subsystem (e.g., DONE 
and BYE commands) 


The command language is described in Section II along with an 
explanation of time-sharing file usage. 


In addition to the normal time-sharing facilities at his disposal, the 
Time-Sharing System user also has access to traditional batch/remote 
batch facilities. This capability is provided by a group of functionally 
interrelated subsystems called the Terminal/Batch Interface Facility. 
The time-sharing terminal user can perform the following operations: 


e Access and modify a file of information created in the batch or 
remote batch dimension. 


e Submit a job, such as a GMAP assembly and execution, to the 
batch dimension and inspect the output directly from his 
terminal. 


e Establish conversational communication between a batch program 
and the user's terminal. 


e Use an adjacent remote batch terminal as a high volume, hard 
copy output device, and, indirectly, as a high volume input 
device. 


The basis for this communication between the several processing 
dimensions is the GCOS File System, which provides a common data base 
for all users of the system, and the common interface provided by GCOS. 
The file system provides automatic storage and retrieval of symbolically 
named permanent files on high capacity storage devices. These files are 
readily accessible in any processing mode. As a byproduct, the use of 
physical file volumes, such as card decks and tape reels, actually 
handled and stored by the user is considerably de-emphasized. 
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Considerable effort has been made to standardize error messages and 
comments throughout the Time-Sharing System, and to have error message 
explanations immediately available at the terminal. Identical error or 
exception conditions arising in different subsystems are identified by 
identical error Message text. Those messages that are not fully 
self-explanatory are prefixed with a message number enclosed by carets 
(i.e.,<nn>), in almost all cases. This message number relates to a 
message explanation as given by the HELP subsystem. Upon encountering an 
error message that he does not fully understand, the user can call the 
HELP subsystem and give the error message number when the number is 
requested. He will then receive an explanation of the error condition 
and suggestions as to possible courses of remedial action, 


The Time-Sharing System is completely modular and open-ended in that it 
is explicitly designed to allow user implemented subsystems, tailored 
for a specific application, to be added to the Honeywell-supplied 
subsystems. This implementation of subsystems can be done readily, with 
no disturbance to the system. Specialized debugging facilities are 
provided for the checkout of new subsystems simultaneous with normal 
time-sharing operation. 
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SECTION II 


COMMAND LANGUAGE AND FILE USAGE 


Operation of time-sharing subsystems is controlled by means of a command 
language--a set of orders or instructions with which a user requests 
functions to be performed (e.g., LIST, RUN), manages the flow of control 
for his session at the terminal (e.g., BYE, DONE), and directs file 
usage (e.g., OLD, NEW). 


The BASIC, Series 6000 FORTRAN, TSS FORTRAN, and CARDIN' subsystems 
accept, or recognize, virtually all of time-sharing command language. 
Other subsystems, Text EDITOR for example, recognize little or no 
command language (as opposed to subsystem commands or conversation). 
Again, a few commands, (PRINT, for example) are applicable to only one 
or two subsystems. These variations from the general commonality are 
summarized in Figure 2-1. When using a particular subsystem, the 
applicability or non-applicability of a command is usually self-evident, 
given an understanding of the nature of the subsystem and the command in 
question, and of the distinction between BUILD mode and Direct Access 
(DAC) mode. 


Time-Sharing commands, strictly speaking, can oniy be given when a 
subsystem is in BUILD mode, a mode in which the subsystem is expecting 
either file building input or commands recognized by that subsystem. 
BUILD mode is indicated by a system-supplied asterisk at the beginning 
of each new input line. The alternative is DAC mode, in which the 
subsystem either recognizes specialized subsystem commands (e.g., the 
EDITOR commands) or conducts a conversational question/answer sequence 
(as in CARDIN). The RUN command, where applicable, always implies a 
change to DAC mode. A number of minor subsystem, primarily of the 
service type, have no BUILD mode phase and go into DAC immediately upon 
selection. Therefore they recognize no command language. 


In the specialized command structures of some subsystems, certain 
time-sharing commands (e.g., SAVE and DONE) are duplicated, both in 
syntax and function, at the direct mode level. These may be _ loosely 
considered as time-sharing commands, but are not truly such because they 
are not recognized in the BUILD mode of some subsystems; e.g., the Text 
Editor subsystem. 
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DEFINITIONS 


e Line Numbers 


Line numbers are required by the BASIC, TSS ALGOL, TSS JOVIAL, 
TSS FORTRAN, and CARDIN subsystems for line sequencing purposes. 
In the case of BASIC, line numbers are also used as statement 
numbers. A line number consists of one to eight numeric 
characters (including leading blanks). A line number may be 
terminated by any nonnumeric character (including a blank). The 
pound sign (#) is not part of the line number, although like 
other nonnumeric characters, it can be used to terminate a_ line 
number. It also has a variety of other uses associated with line 
numbers. 


e Manual Mode 


In manual mode, the user must provide (type) the line numbers 
for each line. 


e Automatic Mode 


In automatic mode, the system provides the line numbers. They 
are printed as the BUILD mode request for input (asterisk) is 
issued. The number is written onto the collector file as a part 
of the statement. 


e New File 


A new file is a temporary file created for the user when he uses 
the command or response NEW. It is assumed the user will build 
a file which then may be saved, thus creating an old file. A new 
file is created by a (destructive) reinitialization of the 
current file, 


e Old File 


An old file is a previously built and saved file which the user 
selects with the OLD command or response, naming the desired 
file. The old file is copied onto the current file where it is 
available to the user for processing or modification. 


e Current File 


The current file is a temporary file assigned to the user, on 
which a new file is built or on which the selected old file is 
copied. Regardless of the intervening commands or _ subsystem 
selections, the current file contains the last NEW or OLD 
selection, with whatever modifications that may have been 
entered. The modifications are, therefore, temporary until the 
file is saved by means of the command SAVE. The original old 
file, if one existed, will not be altered until a RESAVE command 
naming the old file is executed. 
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Collector File 


The collector file is a temporary file assigned to each user 
when he logs on. All input which is not a recognizable command 
is gathered onto this file -- for example, numbered statements. 
Then, when the file becomes full or a command is typed, 
depending upon the subsystem, the collector file is merged with 
the current file and the entire current file is edited and 
sorted if necessary. For example, when the commands RUN, LIST, 
or SAVE are encountered in the BASIC subsystem, and data exists 
in the collector file, it is merged with the current file in 
sort order. (The collector file is normally transparent to _ the 
user.) 


Available File Table 


An Available File Table (AFT) is provided for each Time-Sharing 
System user. This table holds a finite number of file names 
(currently set at 20 including SY** which always remains in the 
AFT) which are entered in the AFT when the files are initially 
accessed (opened). The advantages of the AFT are: 


1. Files requiring passwords or long catalog/file 
descriptions may be referenced by file name alone, once 
they have been entered in the table. 


2. Files used repeatedly remain readily available, thus 
reducing the overhead time and cost of accessing the 
file each time. 


The following commands cause the named permanent files to be 
placed in the AFT. 


RUN filename (s) 
LIST filename (s) 
OLD filename (s) 


SAVE/RESAVE filename(s) 


GET filename (s) 
PRINT filename (s) 
PERM tempfile, filename 
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Because the AFT is of finite length, it can become full. If 
this happens and a command is given which requires a new 
filename to be placed in the AFT, the command subsystem will 
print an error message indicating that the AFT is full. At this 
point, the user must remove any unneeded files from the AFT in 
order to continue. The STATUS FILES command produces a_ listing 
of all of the user's files in the AFT. The REMOVE command can 
be used to remove specified files from the AFT. The files are 
not purged or altered in any way; only the name is removed from 
the AFT and the file is set not-busy. All files (except SY**) 
may be removed by a REMOVE CLEARFILES. 


FILE DESIGNATION 


The designation of permanent files in the following discussion of 
commands is specified in the following formats: 
1. filename where the filename only is required. 


2. filedescr where the full file description may be 
used, in any of the following formats: 


a. filename 
b. filenameSpassword 
c. userid/catalogSpassword... 


/catalogSpassword/filenameSpassword 


If a required password isS not given (format a), the system will 
explicitly ask for the password. 


If a required password is omitted in the string format (format cc), a 
REQUEST DENIED message will be issued. 


If the file was previously opened (e.g., with a GET), only the filename 
need be given regardless of its full description. If the requested file 
is not already open, it must emanate directly from the user's master 
catalog (quick-access type file) in order for formats a4 and b to be 
applicable. 
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Where desired permissions and/or alternate name are applicable, they are 
specified in the following format: 
filedescr,permissions 
or 
filedescr"altname",permissions 
Where: Altname may be a valid file name (one to eight 
characters), enclosed in double quote signs. 


permissions may be any one of the following: 


WRITE (W) 
EXECUTE. (2) 
APPEND (A) 
READ,WRITE (R,W) 
READ,APPEND (R,A) 
Where a desired permissions specification is applicable, a null 


permissions field implies READ and WRITE permissions; i.e., the default 
interpretation for desired permissions is R,W. 


If a file segment specification, of the form (i,j) where i and j_ are 
line numbers, iS given in addition to desired permissions and/or 


alternate name, it must appear last in the specification string; e.g.: 
filedescr,permissions (i,j) 
or 


filedescr"altname", permissions (i,j) 


Examples: 
OLD FIL1$GOGO,R 
SAVE /CAT1/CAT2SMAYI/FILOSHERE 
LIST FILE2SHOHO (1,100) 
PURGE FIL3SARIZ;FIL4;FIL5$SUN 


GET JJONES/DATACAT/BATCHWRLDFIL" INFILE" 


ine) 
| 
Oo 
td 
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FILE NAMES, CATALOG NAMES, AND PASSWORDS 


File names for time-sharing usage must be eight characters or less in 
length, and may be composed of alphanumerics, periods, and minus’ signs. 
Catalog names and passwords may be up to 12 characters in length, and 
composed of the same characters as file names. 


If a batch file with a name longer than eight characters (12 characters 
maximum) is to be accessed, it must be given an alternate name (altname) 
from one to eight characters in length. The renaming is local and 
temporary. An altname may also be used to temporarily rename one or more 
of several duplicately named time-sharing files the user wishes to have 
accessed concurrently. (Permanent files may be duplicately named so long 
as they emanate from different catalogs or subcatalogs, but if they are 
used, they must be appended with an altname. 


COMMANDS 


Following is a description of the Time-Sharing System commands. Although 
the command words are spelled out completely in the following 
descriptions, in general usage those exceeding four characters may be 
shortened to the first four characters (e.g., RESEQUENCE or RESE). Refer 
to the table Command Applicability by Subsystem, Figure 2-1, for 
applications of the commands to particular subsystems. 


e ABC 


Calls the ABACUS subsystem for algebraic-expression evaluation. 


e ACCESS 


Calls the ACCESS subsystem for time-sharing interface with the 
file system. 


@e ASCASC filedescr 1; filedescr 2 


This command, issued under Series 6000 FORTRAN and other 
time-sharing language systems, causes the translation of a 
time-sharing format ASCII file to a standard system format ASCII 
file or vice versa. In both translations, file 1 is converted to 
the format required in file 2. If file 1 is in time-sharing 
ASCII format (logical record type 5), the characters of the file 
are read and converted to the word-oriented standard system 
ASCII format for file 2. File 2 may then be used as input data 
for the language system. If file 1 is in standard system ASCII 
format (logical record type 6), the words in the file are read 
and converted to the character-oriented time-sharing ASCII 
format for file 2. File 2 may then be listed at a terminal. The 
question and answer sequences for this command depend on the 
format of the file to be converted. 
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ASCBCD ascfil;bcdfil 


Under CARDIN, the ASCII time-sharing file specified by ascfil is 
converted to a standard-system-format BCD file on the permanent 
file specified by bcdfil, following the question/answer sequence 
that is initiated by this command if the former file does not 
contain first line reformatting information. Both ascfil and 
bcdfil may be simply a file name or a full file description, as 
required. The ascfil field may specify also the current file .by 
an asterisk. 


AUTOMATIC 
1. AUTOMATIC 


Causes the automatic creation of line numbers, by the 
system, at the point at which the automatic mode is entered 
(or re-entered), with line numbers initially starting at 010 
and incrementing by 10 (or, on re-entry, resuming where’ the 
previous automatic numbering left off). These line numbers 
appear in the terminal copy, and are written in the file, 
just as though the user had typed them. 


2. AUTOMATIC n,m 


Causes the automatic creation of line numbers, as above, but 
starting with line number n and incrementing by m. 


>. AUTOMATIC ,m 


UTO 
AUTOMATIC n, 


Causes automatic creation of line numbers beginning at 10 
and incrementing by m, or beginning at n and incrementing by 
10 (on re-entry, the line numbering resumes where it left 
off). 


ormally the line number will be followed by a blank. Any 
nonblank, nonnumeric character affixed to the end of the command 
AUTOMATIC will cause the blank to be suppressed. For example: 
AUTONB or AUTOMATICX. 


No commands are recognized while in the automatic mode. The 
automatic mode is cancelled by giving a carriage return 
immediately following the issuance of an asterisk and line 
number by the system. The user may not use character delete (@) 
or line delete (CTRL X) to delete characters associated with the 
generated line number or its associated blank. 


BCDASC bedfil; ascfil 


Under CARDIN, the standard-system-format BCD file (permanent) 
specified by bcdfil is converted to an ASCII time-sharing file 
On the permanent file specified by ascfil, following the 
question/answer sequence that is initiated by this command. Both 
bcdfil and ascfil may be simply a file name or a full file 
description, as required. The ascfil field may also specify the 
current file by an asterisk. ~— 
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BPUNCH ascfil 
BPRINT ascfil 


Under CARDIN, the contents of the ASCII time-sharing file 
specified by ascfil are converted to BCD and is punched or 
printed, respectively, at the central computer site, following a 
question/answer sequence initiated by these commands if the file 
does not contain first line reformatting information. These 
commands allow the user to create hard copy backup (cards) for 
his TSS files, and to list long files on a high speed printer. 
Ascfil may be simply a file name or a full file description, as 
required. The ascfil field may also specify the current file by 
an asterisk. 


Since a batch BMC job is spawned by these commands, the batch $ 
IDENT card information is requested by the subsystem, 


BYE 


Causes the computation of the user's system usage charges during 
the session and disconnects the terminal. 


Depending upon the last selected subsystem, the AFT may first be 
scanned for user's temporary files. A message is issued as_ to 
the number of temporary files, then the user is queried as_ to 
the disposition. Each filename is printed followed by a question 
mark. The user may respond as follows: 


1. carriage return - implies the file is to be released; pass 
to next file. 


2. NONE - implies all of the succeeding files are to be 
released. 


3. SAVE filedescr - specifies that the file is to be saved on 


the permanent file described by filedescr. (Refer to the 
PERM command. ) 


CATALOG 
1. CATALOG 


Lists all catalog and file names which emanate from the 
user's own master catalog. 


2 CATALOG #LIB 
Lists all file names in the library. 
3. CATALOG filename 


Prints a list of the attributes of the file specified. The 
file must emanate from the user's catalog. 
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4. CATALOG /catalogl/catalog2 


Prints a list of all catalog and file names which emanate 
from the specified catalog (catalog2 in this case). 


5. CATALOG /catalogl/catalog2* 
Prints a detailed list of catalog2's attributes. 
Passwords need not be given in these catalog commands. However, 
CATALOG applies only to strings which originate from the user's 
(own) master catalog or the library (#LIB). 
DELETE 
Ll. DEGETE ay byCiG ps es 
2. DELETE a-b,c-d 


Lines numbered a through b and c through d are deleted from 
the current file. 


3. DELETE a,b,c-d,e,f-g,... 


Lines numbered a,b,c, through <d,e, .and f£. through. g are 
deleted from the current file. 


4. DELETE <-n 


Acceptable only as first argument, since it implies deletion 
of lines from beginning of current file to. linen. 


Ss- DELETE. n= 


Acceptable only as last argument, since it implies deletion 
of lines n through end of current file. 


6.. DELETE>* 


Causes deletion of all lines in current file. 


DONE 


Causes return from the selected subsystem to the SYSTEM? level. 


EDIT 


Causes the Text Editor subsystem to be called into use. 
Following the READY message, the uSer may exercise any of the 


text editing capabilities available in the Text-Editor 
subsystem. The current file is the recipient OF any 
modification. 
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ERASE filedescr 1;filedescr 2;...;filedescr n 
Erases (overwrites) the file space associated with the specified 
file(s), but does not release the file(s) from the file system, 
(Refer to PURGE and RELEASE commands.) Random files cannot be 
erased. 
FDUMP 
Calls the FDUMP subsystem for file dumping and correction. 
GET filedescr 1;filedescr 2;...;filedescr n 
(permissions and altname applicable 
The permanent file(s) designated by filedescr i will be accessed 
and the filename(s) placed in the AFT. This is a simple means 
by which common data files emanating from other users’ master 
catalogs may be opened. 
HELP 
Calls the HELP subsystem to obtain an error message explanation. 
For example, if the error message 
009 - SYSTEM UNKNOWN 
were issued, the user could call HELP and respond to the request 
PLEASE ENTER MESSAGE NUMBER- 


with 9, if he desired an error message explanation. 


HOLD 


Prevents any console or master user issued warning or 
information message from appearing at the terminal, either in 
printer or paper tape output, until a subsequent SEND command is 
given. The user assumes responsibility for any warnings he may 
miss while the HOLD is in effect. This command is used primarily 
during output of listings for display or reproduction purposes. 
(Refer to the SEND command.) 


JABT snumb (Job Abort) 
Under CARDIN, causes the batch job specified by snumb (and 


Submitted from the same terminal) to be aborted, with an Xl 
abort code assigned. 
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JDAC name (Job Direct Access) 


Under CARDIN or at the subsystem level, allows a time-sharing 
terminal user to establish Direct Access Communication (DAC) 
with a slave program running in the system. The DAC is initiated 
at the subsystem level by 


SYSTEM? JDAC name 


Under the CARDIN subsystem JDAC is initiated at the command 
level by 


SYSTEM? CARDIN 
OLD OR NEW-NEW 
READY 

*JDAC name 


Name refers to the name of a user supplied DAC’ slave program 
(e.g., the Time-Sharing System is a DAC slave program). If the 
program name is not provided in the initial call to JDAC, the 
system will request a program name. When the direct access 
program terminates, the return is to the appropriate level 
(SYSTEM? or build input mode). 


JOUT snumb 
Permits manipulating, from a time-sharing terminal (via a call 
to JOUT subsystem), the output of certain types of batch jobs. 
JSTS snumb (Job Status) 
Under CARDIN, BASIC, and FORTRAN, causes the current batch 
processing status of the job specified by snumb (e.g., 0005T) to 
be printed at the terminal, in plain text. 
LENGTH 
1. LENGTH 
Generates a report of the content length of the current 
file, in terms of 320-word blocks. 
2. LENGTH filedescr 
Generates a report of the type, current size, and content 


length of the permanent file specified by filedescr. Size 
and content length are given in units of 320-word blocks. 
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LIB 


File 


LIST 


1. 


filename 


filename from the library becomes the current file. 


LIST 


Lists the current file on the terminal. 


LIST i,j 


Lists all lines of the current file whose line numbers are 
greater than or equal to i and less than or equal to j. In 
the case of concatenated files where no sort or resequence 
has been performed, multiple sets of lines numbered between 
1 and j may or may not be listed, if such exist. Either i or 
3 may be omitted. Line numbers 1 or 99999999 respectively 
will be assumed. If j is omitted, the comma may also be 
omitted. 7 


LIST filedescr (permissions and altname applicable) 


Lists the file specified by filedescr on the terminal, 
without altering the current file. Filedescr must include at 
least one alpha character if it consists of filename only. 


LIST fidedeser (a 7) 1;...;filedescr (i,j) n 
(permissions and altname applicable) 


Adjoins and lists the specified files or file-segments on 
the terminal. The current file is not altered. The current 
file may be included in the list under the name *. If the 
list is greater than one line in length, it may be continued 
on the next line provided the last nonblank character on the 
first line is a (leading) delimiter. 


LISTH 


Lists the file with a header (date and time) printed at the 
top Of the: Listing. DIST <teormats: (4)4. (2), (3), and (4). -may 
all use the LISTH form instead of LIST. 


LISTEnnn (no intervening blanks allowed) 


List the file(s) as specified by the operand; but with all 
lines to be "broken" or "folded" at the character position 
(nnn) specified. Listing of the line will be continued on 
succeeding line(s). If nnn is omitted, the value 72 is 
assumed. LIST formats (2) through (4) may also use the 
LISTEnnn form in place of LIST. Files containing overlength 
lines (records) may be listed in this manner. 
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peee eh, 


3 1 


List only the specified line(s) nj from the current file. 


de, “GESTS nj n,n 


Sy... BSE 99999999 


If LIST is given with a line number greater than the last 
line number on the current file, then the last line number 
of the current file will be printed. 


LUCID 


This is used instead of the TAPE command for non-ASCII paper 
tape input. The input is stored on the time-sharing TAP* file as 
unaltered eight-bit codes. The TAP* file is left open (unedited 


in the user's AFT). When a pause greater than one second stops 
the tape read, the system returns to the subsystem selection 
(SYSTEM?) level. This command does not function when data 


communication is via a Low Speed Line Adapter (LSLA) on a 
DATANET 355 Communications Subsystem, In the EDITOR subsystem, 
this command takes the form #LUCID. Return is to SYSTEM? level. 


NEW 
1. NEW 


A new file (empty current file) is started. (The system will 
return to the BUILD mode.) The current file is cleared of 
any prior content. 


2. NEWP filedescr (permissions applicable) 


The OLD-NEW (OLDN) subsystem determines whether or not a 
current file (*SRC) has been defined (opened). If the file 
is defined, OLDN deaccesses this file. The named file is 
created by the NEWP command as a quick-access permanent 
file. It has the attributes specified and is opened with an 
alternate name of *SRC. If the named file already exists, an 
error message is sent to the user. This file remains’ the 
user's current file until another form of the OLD or the NEW 
command is given. 


” 
i 


1é 
( 


3. NEWP# filedescr (permission applicable) 


Execution is the same as for NEWP except that the created 
file remains the user's current file until log-off, or until 
another OLDP, OLDP#, NEWP, or NEWP# command is given. The 
normal OLD or NEW commands use this file (i.e. the file 
specified by OLDP# or NEWP#) as the current file. NEWP# and 
OLDP# may be removed by REMOVE CLEARFILES. 
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NEWUSER 


1. 


OLD 


NEWUSER 


Causes the computation of the user's system usage charges 
during the session and initiates a new log-on sequence. 


NEWUSER account number 


Causes the computation of charges for user's previous 
account number, this account number to be closed, and the 
new account number specified to replace the old. Accounting 
data is reinitialized as for a new user but the log-on 
sequence is bypassed; i.e., the previous’ user-id and 
password are assumed. 


OLD filedescr (permissions and altname applicable) 


File filedescr becomes the current file. 


OLD filedescr(i,j) (permissions and altname applicable) 


Lines 2 and j of file filedescr become the current file. 
Filedescr must be a line-numbered file. 


2) 1;..-;f£(i,j) n (permissions and altname 
e 


The n files or file segments are adjoined in the order 
listed and become the current file, where f is a filedescr. 
Adjoining of BASIC files should be done with caution 
(sequence numbers are also statement numbers). The asterisk 
designating the contents of the current file (or segment 


thereof) may appear as a filedescr anywhere in the file 
list. 


Note that these files or segments are concatenated on the 
current file and resequencing may be required for 
Satisfactory operation in Jline-number dependent systems. 
Sorting or resequencing is not automatic. 


OLD f£(i,j) 1:£(1,3) 2:...:£(i,j) n (permissions and altname 
applicable) 


The n files or file segments are merged by line numbers, and 
become the current file, where f is a filedescr 
(colon-separated). If duplicately numbered statements appear 
in two or more files, each such statement appears in the 
order specified by the file list. The asterisk designating 
the contents of the current file (or segment thereof) may 
appear as a filedescr anywhere in the file list. 
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OLD £(i,3) Letliy jj) 288 (2,9) Spaeth (i,j) n 
(permissions and altname applicable) 


A combination of forms (3) and (4). Concatenation or merging 
is performed in the order (from left to right) indicated by 
the file list. 


If the file list is too long for one line, the OLD subsystem 
will request more input when a delimiter is the last 
nonblank character before the carriage return. 


OLDP filedescr (permissions applicable) 


The OLDN subsystem determines if a current file (*SRC) 
and/or the file specified in filedescr have been accessed 
previously. If this file(s) has been accessed, OLDN will 
deaccess them. The specified permanent file is then accessed 
with an alternate name of *SRC and thus becomes the current 
file. This file is the user's current file until another 
form of the OLD or NEW command is given. The contents of the 
file will not be checked or verified for Time-Sharing System 
format. 


OLDP# filedescr (permissions applicable) 


Execution is the same as for the OLDP command, except that 
this file remains the user's current file until log-off, or 
until another OLDP, OLDP#, NEWP, or NEWP# command is’ given. 
The normal OLD or NEW commands use this file (i.e. the file 
Specified by OLDP# or NEWP#) as the current file. OLDP# can 


be removed by REMOVE CLEARFILES. 


NOTE: The OLDN subsystem is called in when the commands OLD, 
NEW or LIB (normal forms) are given by the user. If a NEWP 
or OLDP command was issued and then one of the normal forms 
was typed in, OLDN will deaccess the permanent *SRC file and 
assign a new temporary *SRC file to the user. The permanent 
file remains in the user's catalog until he releases it. 


If a NEWP# or OLDP# command was issued and then one of the 
normal forms was typed in, OLDN will retain the permanent 
file as *SRC. If a NEWP or OLDP was typed in instead of the 
normal form, the permanent *SRC will be deaccessed, and a 
new permanent file with the alternate name *SRC will be 
created and/or accessed. 


If a NEWP# or OLDP# command was issued and then followed by 
another NEWP# or OLDP# command, the OLDN subsystem will 
deaccess the present *SRC file and then create and/or access 
the newly specified *SRC file. 


Merging and concatenation are not allowed with OLDP, NEWP, 
OLDP#, and NEWP#. 
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PARITY/NOPARITY 


i, PARITY 


The data sent from the computer system to a terminal in 
direct access mode is normally in seven-bit, even parity 
code. The PARITY command is only used to return to this mode 
of operation from a NOPARITY mode of operation. 


2. When the NOPARITY (NOPA) command is given, ali data sent 
from the computer system to a terminal in direct access mode 
is in eight-bit, parity independent code. This command may 
be used at the system level or at the command level in 
BASIC, FORTRAN and CARDIN. The NOPARITY (NOPA) command can 
only be used with a Type 4 terminal (teleprinter). 


PERM tempfile;filedescr 


The temporary file tempfile (created by a FORTRAN program) is 
copied onto the permanent file described by filedescr. If the 
file does not already exist, it will be created with general 
read permission. The temporary file name is removed from the AFT 
and the permanent file accessed (name placed in AFT). 


PRINT 
Under CARDIN, print at the terminal all or any part of a source 


file or concatenation of source files, reformatting the file by 
use of format options and/or tab characters, if desired. 


1. PRINT 


The entire current file is reformatted and printed. 


25 PRINT filedescr (1,7) 1-filedescrii,)). 2ruee3 
fa ledescr (1,3) 


The specified file(s) or file-segment(s) are adjoined, 
reformatted, and printed. The current file may be included 
in the string of files by the name *. The current file, 


however, is not affected. If the list is longer than one 
line in length, it may be continued on the next line if the 
last nonblank character of the line is a leading delimiter. 


Following a PRINT command, if the named file does not carry 
reformatting information, a series of questions are asked of 
the terminal user. Responses to CARD FORMAT? are: 


MOVE - implies line numbers are present and are to be moved 
to the sequence number field and printed. 


STRIP - implies line numbers are present and are not to be 
printed. 
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ASIS - implies line numbers are not present in the file, or 
that the file is to be printed "as is", except for tab 
Spacing. 


NORM - implies MOVE option and the standard tab character 
and settings: 


2, 8,16,32;,73 


If the response was not NORM, the question TAB CHARACTER AND 
SETTINGS? is asked. Responses are NORM or aeseries of tab 
characters and settings of the form: 


tab,,setting,,,setting),.-.;tab,,setting,,,settingos... 


PURGE filedescr 1:filedescr 2;...;filedescr n 


Releases the specified file(s) from the file system and 
overwrites the released file space. (Refer to RELEASE and ERASE 
COMMANDS. ) 


RECOVER filename $ password (password optional) 


The permanent file designated by filename is created and/or 
accessed, and itl becomes the input collector file emanating from 
the user's master catalog. The permanent file is created 
without general permissions assigned. (The command is #RECOVER 


when given in the EDITOR subsystem.) 

#RECOVER filename $ password (password optional) 

The permanent file designated by filename is created and/or 
accessed, and it becomes the input collector file emanating from 
the user's master catalog. The permanent file is created 
without any general permissions assigned. This command is only 
applicable to the EDITOR subsystem. 

RELEASE filedescr 1l;filedescr 2;...;filedescr n 

Releases the specified file(s) from the file system, but without 
overwriting the associated file space. (Refer to PURGE and 
ERASE commands.) 


REMOVE filename 1;filename 2;...;filename n 


Removes the specified file name(s) from _ the AFT, tL eaey 
deaccesses the named file(s). 
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REMOVE CLEARFILES 


Removes all files except SY** from the AFT including the current 
file. 


RESAVE filedescr 1; filedescr 2;...;filedescr n 


The contents of the current file are saved on the previously 
existing permanent file(s) specified by filedescr i, replacing 
any prior content thereof. Sorting by line number is or is not 
done according to subsystem requirements. (Refer to the SAVE 
command. ) 


RESEQUENCE 


1. RESEQUENCE 


The line numbers of the current file are resequenced. The 
resequencing begins with line number 10 and continues in 
increments of 10. If BASIC is the selected subsystem, the 
file is resequenced and statement number references in the 
program are modified correspondingly (GOTO, GOSUB, IF, ON, 
Print USING). If FORTRAN or CARDIN was’ selected, statement 
number references are not affected. 


2. RESEQUENCE n,m,x-y 


The line numbers of the current file are resequenced and 
modifications made according to the subsystem selection. The 
resequencing begins with line number n and continues in 
increments of m. is 


x and y are specified only if partial resequencing is 
desired. x gives the starting point and y the ending point 
of resequencing, inclusive. A null x field (i.e., -y) 
specifies from beginning of file to line y, and a null y 
field (i.e., x-) specifies from line x to the end of file. 


In general, any blanks preceding a line number are stripped 
off. Unnumbered lines are accepted, except under the BASIC 
subsystem, and will have line numbers added, as implied or 
specified in the command. Care _ should be taken in 
resequencing concatenated BASIC files as line numbers are 
also statement numbers, and statement references, after 
resequencing, may become invalid. 


3s. (‘RESEX -n,m 


Line numbers are inserted at the beginning of each line in 
the current file, regardless of whether or not line numbers 
already exist. The numbering begins with n and increments by 
mM, Or Optionally, begins with 10 and increments by 10, if 
n,m are not specified. If the first character of the 
existing line is a numeric, a blank is inserted following 
the generated line number. If the first character of the 
existing line is not numeric, no such blank is inserted. 
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4. RESE# n,m 


Line numbers are inserted at the beginning of each line in 
the current file, even if line numbers already exist. This 
numbering begins with n and increments by m, or optionally 
begins with 10 and increments by 10 if n, m are not 
specified. If the first character of the existing line is a 
numeric, a pound sign (#) is inserted following the 
generated line number. If the first character of the 
existing line is not numeric, the pound sign is not 
inserted. 


CAUTION: When resequencing, or performing a partial resequence, 
it is possible to produce files with line numbers out of 
order. This may be caused by incorrect parameters on partial 
resequence or when new line numbers exceed eight digits (in 
non BASIC files). When line numbers are too large, a warning 
is given. In either case, recovery may be made by 
resequencing the total file using a smaller beginning line 
number or a smaller increment. 


ROLLBACK filename$password (password optional) 


The permanent file designated by filename is accessed with 
general Read and Write permissions assigned. This file becomes 
the input collector file emanating from the user's master 
catalog. When accessed, the permanent file is read and any data 
on the file is copied to the current working file. The last line 
of good data on that file is printed out at the terminal as 
follows: 


LAST LINE OF SAVED DATA IS: 


followed by the last line of good data (in the EDITOR subsystem, 
this command is #ROLLBACK). 


#ROLLBACK filename$password (password optional) 


The permanent file designated by filename is accessed with 
general Read and Write permissions assigned. This file becomes 
the input collector file emanating from the user's master 
catalog. When accessed, the permanent file is read and any data 
on the file is copied to the current working file. The last line 
of good data on that file is printed out at the terminal as 
follows: 


LAST LINE OF SAVED DATA IS: 


followed by the last line of good data (this command applies 
only to the EDITOR subsystem). 
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RUN 


RUN 


Executes the selected subsystem. The source input is the 
current file. (If BASIC is the subsystem selection and any 
variation of the RUN command is given, only the current file 
is executed; i.e., any information appended after the RUN 
command is ignored.) 


RUN filedescr (permissions and altname applicable) 


Under FORTRAN, compiles and executes the file specified by 
filedescr. Under CARDIN, converts and passes the specified 
file to the GCOS System Input program (formerly referred to 
as GEIN). 


RUN = filedescr = (option 1,...,option n) 
(permissions and altname applicable if file aiready exists.) 


Under FORTRAN, compiles and executes the current file using 
the specified options. Save the object program on the file 
specified by filedescr. If this file does not already exist, 
it will be created (with general Read permission). 


RUN filedescr 1;...;filedescr(i,j) n 

= filedescr x (option 1,...,option n) 

(permissions and altname applicable to already existent 
files) 


Under FORTRAN, the specified files or file-segments are 
adjoined and compiled/executed according to the options 
specified, and the object program saved as file filedescr. 
The compile options and saving of object file are optional. 
The designated files may be object or source files. (Object 
files must be random files.) 


The current file may be indicated by an asterisk in the file 
list. Caution must be exercised to ascertain that the 
current file contains that which is expected. 


If a list is too long to be typed on one line, the subsystem 
requests more input if a delimiter is the last nonblank 
character before the carriage return. 


RUN fs = fh; fc(opt) ulib #fe 


Under the Series 6000 FORTRAN, TSS ALGOL and TSS JOVIAL 
subsystems, this command calls in the RUN’ subsystem to 
compile and execute, using the parameters and options 
specified in the command. The format definition is as 
follows: 


fs - set of file descriptors for input to the compiler 
and/or loader. 


fh - single file descriptor pointing to a random file 
used to save the system loadable file produced by 
the General Loader (formerly referred to as 
GELOAD) if the compilation is successful. 
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fe - single file descriptor pointing to a sequential 
file in which the compiler places the binary 
deck(s) from the compilation(s). 


fe - set of file descriptors for files required for 
execution. 


opt - set of options to be used in the 
compilation/execution. 


ulib 


sequence of file descriptors pointing to random 
files containing user libraries. 


Refer to Series 6000 FORTRAN reference manual for procedures 
for using this RUN command. 


6. RUNH 


Executes the selected subsystem and prints a header (date 
and time) at the top of the program execution report. RUN 
formats (1), (2), (3), and (4) may all use the RUNH form in 
place of RUN. 


7. %RUN-nn 
In Series 6000 FORTRAN, Time-Sharing FORTRAN, Time-Sharing 
ALGOL, Time-Sharing JOVIAL, and BASIC, nn is a 
user-specified processor object time limit (in seconds) for 


job execution. The value of nn must be less than the 
processor object time limit set by the installation or it 
will be disregarded. 


RUN-nn may be used with any of the other RUN forms; e.g. 
RUNH-nn. 


SABT 


The Scan Abort (SABT) subsystem allows the user to scan the ABRT 
file by snapping portions of the file at the terminal. This file 
is established by the user so that a subsystem that is aborted 
may be copied on it. The abort may be caused by a uncorrectable 
fault in a subsystem or by execution of a DRL ABORT. 


SAVE filedescr 1,permissions,size; 
filedescr 2,permissions,size;....filedescr n 


The current file is saved on one or more new permanent file(s) 
defined by filedescr i. Sorting by line number is or is not 
done, according to subsystem requirements. The file(s) specified 
are created with no general permissions or with the permissions 
specified in the SAVE command. A maximum size can be specified 
in the command by typing in the word SIZE or the letter §& 
followed by the numeric size value. If no size is specified, the 
subsystem will determine a maximum size based on the program 
Size. Size and permissions may be interchanged. 
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SCAN filedescr (permissions and altname applicable) 

Under CARDIN, the SCAN subsystem -- batch-output scanner -- is 
initiated to scan the file described by filedescr. The desired 
functions are defined by the question/answer sequence that 
follows the use of this command. 

SEND 

Cancels the effect of a previous HOLD command, and causes’ the 


last message previously withheld to appear at the terminal. 
(Refer to the HOLD command.) 


STATUS 


Ls STATUS 
Lists the user's status as to processor time used, number of 
file I/O's, and characters output to the terminal; and lists 
the files that are open. 


2. STATUS FILES 


Lists only the names of the user's open files. 


SYSTEM name 


Exits from the current subsystem and calls the named subsystem, 
OF; act no name is given, returns control to the 
subsystem-selection level (SYSTEM?). This command permits’ the 
user to bypass the normal DONE--SYSTEM? sequence. 


TAPE 


Builds or extends a current file with input from paper tape. 
Neither line feeds nor rubouts are supplied by the Time-Sharing 
System. (The command is #TAPE when given in the EDITOR 
subsystem. ) 


#TAPE 
Builds or extends a current file with input from paper tape. 


Neither line feeds nor rubouts are supplied by the Time-Sharing 
System. This command is only applicable to the EDITOR subsystem. 
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SUBSYSTEM 


COMMAND ALGOL BASIC CARDIN EDITOR FORTRAN 6000FORTRAN JOVIAL 
ABC e e e e e e 
ACCESS e e e e! e e e 
ASCASC e e e e @ 
ASCBCD e 

AUTOMATIC? e e e Py ° e 
BCDASC e 

BPRINT e 

BPUNCH e 

BYE e e e oe! e r e 
CATALOG e e e e! e e e 
DELETE? e e e e e e 
DONE 2 e e e e! e ° e 
EDIT e e e : e e e 
ERASE e C) e e! e e e 
FDUMP e 

GET e e e e e e 
HELP e e e e e e 
HOLD e e e e e ® 
JABT e 

JDAC e 

JOUT e e e e e 
JSTS e e e e e e 
LENGTH e e e e! e e e 
LIB? e e e e e e 
LIstT2 e ) e e r) ) 
LUCID2 e s e e e e 
#LUCID? e 

NEw? e e e e e e 
NEWUSER e e e e e e 
NOPARITY e e e e ® e 
OLD? e e e e! e e e 
PARITY e e e e e e 
PERM? e e e e 
PRINT2 e 

PURGE? e e e e! r s © 
RECOVER e e e e e e 
# RECOVER? e 

RELEASE? e e e e! e e e 
REMOVE e e e e e e e 
RESAVE?2 e e e! e e e 
RESEQUENCE? e e e e e e 
ROLLBACK? e e e e e e 
#ROLLBACK? ee) 

RUN2 e e e e e e 
SAVE? e e e eo! e e e 
SCAN e 

SEND e e e e e e 
STATUS e e e e! e e e 
SYSTEM? © e e e @ e 
TAPE? e e e e e e 
#TAPE? e 


Figure 2-1. Command Applicability by Subsystem 


BSO1 


SECTION III 


TIME-SHARING ERROR MESSAGES EXPLANATION 


Error messages generated by the various time-sharing subsystems and by 
the Time-Sharing System Executive program fall into two classes (from 
the viewpoint of explanations): 


e Error messages that are considered self-explanatory. 


@e Error messages that, due to the need for reasonable conciseness 
in conversational messages, may require further explanation for 
a given user the first few times that the message is 
encountered. 


All messages falling into the second class are prefixed by a message 
number, usually enclosed by carets (1i.e., <nn> , or in some cases <nn<). 
Further explanation of these messages is immediately available at the 
terminal through the HELP subsystem. HELP may be called for either at 
the subsystem-selection level (SYSTEM?) or at the command level under 
most major subsystems. 


morn 


HELP messaye explanations are listed bélow, indexed under the associated 
error message(s). These error messages, in turn, fall into two 


categories from the viewpoint of origin and applicability. 


e Error messages originating from the time-sharing Executive, most 
of which can be received only by an implementor of a new, not 
fully debugged, time-sharing subsystem during its checkout. 


These messages are numbered 1 through 49, 


e Error messages originating from the various time-sharing 
subsystems, which would be received by a user of the _ system. 
These messages indicate faulty system usage or system 


malfunction, and are numbered beginning with 50. 


Note 
On some types of terminals, the carets enclosing the 


error message number are reproduced as parentheses. 


In the following descriptions, generated error messages and their 
associated HELP subsystem error message explanations are listed by 
message numbers. 
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001 - INCORRECT PRIMITIVE 


AN ILLEGAL PRIMITIVE HAS OCCURRED IN A COMMAND LIST. CHECK THE COMMAND 
LIST POINTER IN THE PROGRAM DESCRIPTOR AND THE COMMAND LIST FORMAT AND 
PRIMITIVES. 


002 - BAD FILE I/O COMMAND 


IN THE CALLING SEQUENCE OF A DRL FOR FILE I/0, THE COMMAND WORD IS 
INCORRECT. CHECK THE SUBSYSTEM CODE. 


003 - BAD DCW 


IN THE CALLING SEQUENCE OF A DRL FOR FILE I/0, A DCW IS INCORRECT. CHECK 
THE SUBSYSTEM CODE. 


004 - location ADDRESS OUT OF RANGE 


THE ADDRESS OF A DRL ARGUMENT IS OUTSIDE THE RANGE OF THE PROGRAM. THE 
NUMBER GIVEN IN THE COMMENT IS THE RETURN FROM THE DERAIL. CHECK THE 
SUBSYSTEM CODE FOR IMPROPER INITIALIZATION. 


005 - BAD DRL CODE 


THE ADDRESS OF A DRL CODE IS OUT OF THE RANGE OF USABLE CODES OR ILLEGAL 
FOR THIS SUBSYSTEM. CHECK THE SUBSYSTEM CODE. 


006 - LEVEL OF CONTROL TOO DEEP 


THE MAXIMUM NUMBER OF CALLS IN THE PROGRAM STACK OR THE CALLSS STACK HAS 
BEEN EXCEEDED. IN THE CASE OF THE PROGRAM STACK, THIS MEANS THAT THE 
SELECTED SYSTEMS PRIMITIVE LIST CONTAINED A CALLP, AND IN TURN, THAT 
SUBSYSTEMS PRIMITIVE LIST CONTAINED A CALLP, ETC. UNTIL THE LENGTH OF 
THE PROGRAM STACK WAS EXCEEDED. LIKEWISE, IN THE CASE OF THE CALLSS 
STACK OF SUBSYSTEMS CALLING OTHER SUBSYSTEMS BY MEANS OF THE DRL CALLSS, 
THE TABLE LIMIT WAS EXCEEDED. REVIEW THE SUBSYSTEM AND DEPTH OF CALLS. 


007 - BAD PROG. DESCRIPTION 


IN THE PROGRAM DESCRIPTOR, THE POINTER TO THE COMMAND LIST IS ZERO OR 
POINTS TO NON-COMMAND LANGUAGE DATA. CHECK THE PROGRAM DESCRIPTOR AND 
COMMAND LANGUAGE LIST. 


008 - LOOP IN PRIMITIVES 


A NUMBER OF THE PRIMITIVES ARE EXECUTED ENTIRELY WITHIN THE TSS _ SCAN 
MODULE. A COUNTER IS INITIALIZED AT THE ENTRY TO SCAN AND A COUNT KEPT 
OF PRIMITIVES EXECUTED. WHEN THE COUNT EXCEEDS A GIVEN MAXIMUM, IT 
BECOMES OBVIOUS THERE IS A LOOP. CHECK THE SEQUENCE OF THE PRIMITIVES 
FOR THE SUBSYSTEM. 
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009 - SYSTEM UNKNOWN 


THE REQUESTED SUBSYSTEM IS UNKNOWN TO TSS OR IS NOT INCLUDED IN THE 
SYSTEM FOR THIS INSTALLATION. CHECK THE NAME FOR SPELLING TOO. 


010 - PROGRAM TOO LARGE TO SWAP 


A SUBSYSTEM IS SO LARGE THAT THE NUMBER OF DCW'S REQUIRED TO LOAD OR 
SWAP THE PROGRAM EXCEED THE MAXIMUM NUMBER OF DCW'S WHICH CAN BE’ BUILT. 
CHECK THE SIZE OF THE SUBSYSTEM. PERHAPS THE SUBSYSTEM EXPANDS ITS CORE 
LIMITS WITH A DRL ADDMEM. CHECK ALL DRL ADDMEM REQUESTS. SEE .LADCW 
DEFINED IN COMMUNICATION REGION FOR MAXIMUM NUMBER OF DCW'S ALLOWED. 


011 - INCORRECT CORE FILE USAGE 


A REQUEST TO MOVE CORE FILE SPECIFIES MORE THAN TEN WORDS TO BE MOVED. 
CHECK ALL DRL CORFIL REQUESTS. 


012 - PROGRAM NOT ALLOWED USE OF THIS I/0 


PRIVILEGED FILE I/0 IS RESERVED FOR SUBSYSTEMS WHICH SPECIFICALLY 
REQUIRE INFORMATION FROM FILES ALLOCATED TO THE TIME-SHARING SYSTEM. 
PLEASE REVIEW THE NEED FOR PRIVILEGED FILE I/O AND JUSTIFY IT WITH THE 
COMPUTING CENTER. 


013 - DRL ALLOWED ONLY BY LOGON 


THE DRL USER ID CAN BE USED ONLY BY THE LOGON SUBSYSTEM. CHECK THE 
SUBSYSTEM CODE. 


014 - NOT CURRENTLY ASSIGNED 


015 - CANNOT RESET ID 


THE LOGON SUBSYSTEM IS EXECUTING A DRL USER ID, BUT THE ID OF THE 
SPECIFIED U.S.T. IS NON-ZERO. A TERMINATE MUST BE EXECUTED FOR THAT USER 
BEFORE THE U.S.T. CAN BE REUSED. TRY TO DETERMINE WHY THE TERMINATE WAS 
BYPASSED, OR WHY NEW SYSTEM WAS SELECTED AFTER LOGON. 


016 - location OVERFLOW FAULT 


THE SUBSYSTEM IN EXECUTION ENCOUNTERED AN OVERFLOW CONDITION AT THE 
DESIGNATED LOCATION AND THE SUBSYSTEM DID NOT SPECIFY A FAULT VECTOR. 
THE LOCATION TIS RELATIVE TO ZERO (SEE EDIT MAP) UNLESS IT IS A MASTER 
SUBSYSTEM. THEN THE LOCATION IS RELATIVE TO TSS ZERO. DETERMINE THE LOAD 
ADDRESS OF THE SUBSYSTEM TO DETERMINE THE FAULT LOCATION IN THE MASTER 
SUBSYSTEM. REVIEW YOUR PROGRAM INPUT FOR INCORRECT DATA BEFORE 
REQUESTING HELP FROM THE COMPUTING CENTER. 
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017 - location ILLEGAL OP CODE 


THE SUBSYSTEM IN EXECUTION ENCOUNTERED AN ILLEGAL (OR ZERO) OP CODE 
OR A MME OPERATION AT THE DESIGNATED LOCATION, AND THE SUBSYSTEM DID NOT 
SPECIFY A FAULT VECTOR. 

THE LOCATION IS RELATIVE TO SUBSYSTEM ZERO (SEE EDIT MAP) UNLESS IT 
IS A MASTER SUBSYSTEM, THEN THE LOCATION IS RELATIVE TO TSS _ ZERO. 
DETERMINE THE LOAD ADDRESS OF THE SUBSYSTEM TO DETERMINE THE FAULT 
LOCATION IN THE MASTER SUBSYSTEM. 

REVIEW YOUR PROGRAM CODE AND INPUT FOR INCORRECT DATA BEFORE 
REQUESTING HELP FROM COMPUTING CENTER. 


018 - location MEMORY FAULT 


THE SUBSYSTEM IN EXECUTION ENCOUNTERED A MEMORY FAULT AT THE 
DESIGNATED LOCATION, AND THE SUBSYSTEM DID NOT SPECIFY A FAULT VECTOR. 

THE LOCATION IS RELATIVE TO SUBSYSTEM ZERO (SEE EDIT MAP) UNLESS IT 
IS A MASTER SUBSYSTEM, THEN THE LOCATION IS RELATIVE TO TSS ZERO. 
DETERMINE THE LOAD ADDRESS OF THE SUBSYSTEM TO DETERMINE THE FAULT 
LOCATION IN THE MASTER SUBSYSTEM. 

REVIEW THE PROGRAM CODE AND INITIALIZATION OF ADDRESS OR INDEX 
REGISTERS AS WELL AS THE PROGRAM INPUT FOR INCORRECT DATA BEFORE 
REQUESTING HELP FROM THE COMPUTING CENTER. 


019 - location FAULT TAG FAULT 


THE SUBSYSTEM IN EXECUTION ENCOUNTERED A FAULT TAG FAULT AT THE 
DESIGNATED LOCATION, AND THE SUBSYSTEM DID NOT SPECIFY A FAULT VECTOR. 

THE LOCATION IS RELATIVE TO SUBSYSTEM ZERO (SEE EDIT MAP) UNLESS IT 
IS A MASTER SUBSYSTEM, THEN THE LOCATION IS RELATIVE TO TSS _ ZERO. 
DETERMINE THE LOAD ADDRESS OF THE SUBSYSTEM TO DETERMINE THE FAULT 
LOCATION IN THE MASTER SUBSYSTEM. 

REVIEW THE PROGRAM CODE AND INITIALIZATION OF ADDRESS OR INDEX 
REGISTERS AS WELL AS THE PROGRAM INPUT FOR INCORRECT DATA BEFORE 
REQUESTING HELP FROM THE COMPUTING CENTER, 


020 - location DIVIDE CHECK FAULT 


THE SUBSYSTEM IN EXECUTION ENCOUNTERED A DIVIDE CHECK FAULT AT THE 
DESIGNATED LOCATION, AND THE SUBSYSTEM DID NOT SPECIFY A FAULT VECTOR. 

THE LOCATION IS RELATIVE TO SUBSYSTEM ZERO (SEE EDIT MAP) UNLESS IT 
IS A MASTER SUBSYSTEM, THEN THE LOCATION IS RELATIVE TO TSS ZERO. ONE 
MUST DETERMINE THE LOAD ADDRESS OF THE SUBSYSTEM TO DETERMINE THE FAULT 
LOCATION IN THE MASTER SUBSYSTEM, 

REVIEW YOUR PROGRAM INPUT FOR INCORRECT DATA BEFORE REQUESTING HELP 
FROM THE COMPUTING CENTER. 


021 - BAD STATUS SWAP OUT #S 
A BAD I/O STATUS HAS BEEN RECEIVED ON A WRITE DRUM FILE #S, THE SWAP 


FILE. TRY AGAIN. IF PROBLEM PERSISTS, THE TSS WILL ALERT OPERATIONS. THE 
PARENTHESIZED NUMBER IS THE STATUS CODE. 
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022 - BAD STATUS SWAP IN #S 

A BAD I/O STATUS HAS BEEN RECEIVED ON A READ DRUM FILE #S, THE SWAP 
FILE. TRY AGAIN. IF PROBLEM PERSISTS, THE TSS WILL ALERT OPERATIONS. THE 
PARENTHESIZED NUMBER IS THE STATUS CODE. 

023 - BAD STATUS LOAD #P 

A BAD I/O STATUS HAS BEEN RECEIVED ON A READ DRUM FILE #P, THE TSS FILE. 
TRY AGAIN. IF PROBLEM PERSISTS, THE TSS WILL ALERT OPERATIONS. THE 
PARENTHESIZED NUMBER IS THE STATUS CODE. 

024 - BIT POSITION > 35 

THE DESIGNATED BIT POSITION IN AN IF TRUE OR IF FALSE PRIMITIVE IS 
GREATER THAN 35. CHECK THE COMMAND LIST AND PRIMITIVES OF THE SUBSYSTEM. 
ERROR-CODE 25 NOT CURRENTLY ASSIGNED. 


ERROR-CODE 26 NOT CURRENTLY ASSIGNED. 


ERROR-CODE 27 NOT CURRENTLY ASSIGNED. 


028 - USER TRIED TO SPACE A RANDOM FILE 


oD 


A RANDOM FILE CANNOT BE SPACED IN THIS MANNER. 
IN THE CORRECT MANNER WILL CLEAR UP THE PROBLEM, 


ve) 
ca 
ep) 
Hed 
G 

3] 
oO 
try 
ry 
iG 
ty 
y 
> 
Zz 
gO 
O 
= 
hy 
WH 
to 
ta 


029 - ILLEGAL SYSTEM SELECTION 
SOME SYSTEMS, NAMELY THE MASTER SUBSYSTEMS, HAVE RESTRICTED THEIR 


AVAILABILITY TO CERTAIN USERS. YOU DO NOT HAVE PERMISSION TO USE THE 
SELECTED SUBSYSTEM. SELECT ANOTHER. 


ERROR CODES 30-49 NOT CURRENTLY ASSIGNED. 


<50> FILE filename -- reason text 

<50< FILE filename -- reason text 

(The two messages above refer to permanent files.) 
<50> CURRENT FILE -- reason text 

<50> COLLECTOR FILE -- reason text 


(The two messages above refer to the temporary files *SRC and Sy**, 
respectively.) 


<50> WORK FILE -- reason-text 


(The message above refers to all other temporary files.) 
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ERROR-MESSAGE 50 EXPLANATION: FILE-SYSTEM ERRORS. 


THIS MESSAGE IS ISSUED FOR EITHER ONE OF TWO CASES: (1) THE NAMED 
PERMANENT FILE COULD NOT BE ACCESSED-- <50>, OR COULD NOT BE 
CREATED-~-<50< OR (2) A REQUIRED TEMPORARY FILE COULD NOT BE OBTAINED OR 
EXPANDED. THE REASON GIVEN IN THE MESSAGE IS FURTHER EXPLAINED BELOW: 


STATUS 01: THE SPECIFIED USER'S~MASTER-CATALOG DOES NOT EXIST. CHECK 
USER-ID,. 


I/O ERROR, STATUS 02: THE FILE SYSTEM HAS ENCOUNTERED AN UNRECOVERABLE 
INTERNAL I/O ERROR. (THIS DOES NOT IMPLY AN ERROR ON YOUR FILE SPACE.) 
REPORT THE STATUS TO THE CENTRAL COMPUTER SITE. ALSO RETRY. 


NO PERMISSION, STATUS 03: THE NAMED FILE COULD NOT BE ACCESSED BECAUSE 
YOU HAVE NOT BEEN ALLOWED THE PERMISSION(S) REQUESTED. 


FILE BUSY, STATUS 04: ANOTHER USER HAS ALREADY ACCESSED THIS FILE WITH 
AN ACCESS-MODE PERMISSION THAT LOGICALLY EXCLUDES YOUR REQUESTED 
PERMISSION; I.E., A GRANTED WRITE PERMISSION EXCLUDES ANY OTHER 
CONCURRENT ACCESSES AND A GRANTED READ PERMISSION EXCLUDES ANY OTHER 
ACCESS WITH WRITE PERMISSION. THE FILE, THEREFORE, IS TEMPORARILY BUSY 
TO SOME OR ALL OTHER USERS. (MULTIPLE CONCURRENT ACCESSES OF A FILE WITH 
READ PERMISSION, ONLY, IS ALLOWED.) 


NONEXISTENT FILE, STATUS 05: EITHER THE NAMED FILE DOES NOT EXIST, AT 
THE CATALOG LEVEL IMPLIED OR SPECIFIED, OR ONE OR MORE NAMES IN THE 
CATALOG/FILE DESCRIPTION WAS INCORRECTLY GIVEN. CHECK ALL CATALOG/FILE 
NAMES. THE COMMAND CATALOG MAY BE USED TO LIST ALL OF YOUR CATALOG AND 
FILE NAMES. 


STATUS 06: THE FILE SYSTEM HAS EXHAUSTED ITS SPACE FOR NEW CATALOGS AND 
FILE DESCRIPTORS. REPORT THE STATUS TO THE CENTRAL COMPUTER SITE, AND 
TRY AGAIN LATER. 


DEVICE TYPE UNDEFINED, STATUS 07: THE DEVICE TYPE THAT YOU SPECIFIED FOR 
YOUR FILE IS UNDEFINED TO THE SYSTEM. 


STATUS 10: THE SYSTEM HAS TEMPORARILY EXHAUSTED THE AVAILABLE FILE 
SPACE. TRY AGAIN LATER. (ALSO, PURGE ANY UNNEEDED FILES.) 


NON-UNIQUE NAME, STATUS 11: THE NEW NAME THAT YOU HAVE SPECIFIED FOR THE 
CATALOG OR FILE TO BE MODIFIED IS A DUPLICATE OF A CATALOG OR FILE NAME 
EXISTING AT THE SAME LEVEL. 


MAX. SIZE ERROR, STATUS 12: THE NEW MAXIMUM-SIZE SPECIFIED FOR THE FILE 
TO BE MODIFIED IS LESS THAN ITS CURRENT SIZE. (MAXIMUM SIZE UNCHANGED.) 
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NO FILE SPACE, STATUS 13: YOU HAVE USED UP ALL THE PHYSICAL SPACE 
ALLOTTED TO YOU FOR THE CREATION OF FILES. YOU MUST EITHER PURGE ONE OR 
MORE UNNEEDED FILES, OR OBTAIN A LARGER FILE-SPACE ALLOCATION. 


INVALID PASSWORD, STATUS 14: A REQUIRED PASSWORD EITHER HAS BEEN GIVEN 
INCORRECTLY OR NOT AT ALL. THE GENERAL FORM FOR SUPPLYING PASSWORDS IN A 
CATALOG/FILE DESCRIPTION IS: NAMESPASSWORD E.G.: /CATISABC/FILI1SXYZ. 


STATUS 15 THRU 33, AND 35: SYSTEM MALFUNCTION. REPORT THE STATUS TO THE 
CENTRAL COMPUTER SITE, AND RETRY. 


ILLEGAL CHAR., STATUS 34: YOU HAVE GIVEN A CATALOG OR FILE NAME, OR A 
PASSWORD, CONTAINING A CHARACTER OTHER THAN AN ALPHANUMERIC, PERIOD, OR 
A DASH, WHICH ARE THE ONLY LEGAL CHARS. FOR IDENTIFIERS. 


FILE TABLE FULL, STATUS 36: THE NAMED FILE CANNOT BE ACCESSED BECAUSE 
YOU PRESENTLY HAVE TOO MANY FILES ALREADY ACCESSED (I.E., OPENED). YOU 
MUST DEACCESS ONE OR MORE OF THESE OPENED FILES. USE THE COMMANDS STATUS 
FILES, AND REMOVE. 


DUPLICATE NAME, STATUS 37: THE FILE NAME SHOWN DUPLICATES A NAME ALREADY 
IN YOUR AVAILABLE-FILE-TABLE, I.E., AN ALREADY ACCESSED FILE. IF 
APPROPRIATE, ASSIGN AN ALTERNATE NAME. 


SYSTEM LOADED, STATUS 40: THE SYSTEM IS CURRENTLY AT PEAK CAPACITY IN 
SOME RESPECT, E.G.: CERTAIN INTERNAL TABLE SPACE EXHAUSTED, ETC. 


<51> FILE filename -- I/O STATUS yy 


IK 


<5l< FILE filename -- I/O STATUS yy 
(The two messages above refer to permanent files.) 
<51> CURRENT FILE -- I/O STATUS yy 

<51< CURRENT FILE -- I/O STATUS yy 

(The two messages above refer to the *SRC file.) 
<51> COLLECTOR FILE -- I/O STATUS yy 

<51< COLLECTOR FILE -- I/O STATUS yy 


(The two messages above refer to the SY** file.) 
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<51> WORK FILE -- I/O STATUS yy 

<51< WORK FILE -- I/O STATUS yy 

(The two messages above refer to all other temporary files.) 

where yy is the major hardware status returned by 10S. These _ status 
codes are described in the Comprehensive Operating Supervisor reference 
manual. 

ERROR-MESSAGE 51 EXPLANATION: INPUT/OUTPUT ERRORS 

AN UNRECOVERABLE READ OR WRITE ERROR HAS OCCURRED ON THE SPECIFIED FILE. 
AN ERROR IN READING IS INDICATED BY THE MESSAGE NUMBER GIVEN AS <51>; AN 
ERROR IN WRITING AS <51<. REPORT THE I/O STATUS NUMBER AND THE READ OR 
WRITE INDICATION TO THE CENTRAL COMPUTER SITE. ALSO, IN THE CASE OF 
"CURRENT FILE" or "WORK FILE", LOG OFF AND TRY AGAIN. 

<52> CURRENT FILE NOT DEFINED 

ERROR-MESSAGE 52 EXPLANATION 

THERE IS NO CURRENT (*SRC) FILE DEFINED IN YOUR FILE TABLE. THIS 
INDICATES EITHER A SYSTEM MALFUNCTION, OR THAT YOU ARRIVED AT THE 


PRESENT SUBSYSTEM VIA AN ABNORMAL PATH. SUGGEST YOU RESELECT YOUR 
DESIRED SUBSYSTEM, OR LOG OFF AND RETRY FROM SCRATCH. 


<53> LINES IGNORED BY EDIT 
--.-Line(S)....e. 
ERROR-MESSAGE 53 EXPLANATION 
THE LINE(S) SHOWN WERE NOT MERGED INTO YOUR CURRENT FILE BECAUSE THEY 
LACKED LINE NUMBERS. 
<54> SYSTEM MALFUNCTION--CURRENT FILE ERROR 
ERROR-MESSAGE 54 EXPLANATION 
THE FORMAT OF YOUR CURRENT FILE WAS FOUND TO BE IN ERROR. REPORT 
CIRCUMSTANCES TO THE CENTRAL COMPUTER SITE. SUGGEST THAT YOU LOG OFF AND 
RETRY. 
<55> CURRENT FILE TOO LARGE 
ERROR-MESSAGE 55 EXPLANATION 
THE COMBINED SIZE OF YOUR SOURCE FILE AND MOST RECENT MODIFICATION- OR 


ADDITION-INPUT IS TOO LARGE TO BE PROCESSED. SUGGEST THAT YOU SPLIT THE 
TEXT INTO TWO OR MORE FILES, WHICH CAN LATER BE ADJOINED. 
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<56> FORTRAN LOADER CODE = nn 


ERROR-MESSAGE 56 EXPLANATION 


YOUR OBJECT PROGRAM COULD NOT BE PROPERLY LOADED/EXECUTED, FOR THE 
REASON INDICATED BY THE CODE NUMBER: 


0-31 - THESE CODES, GIVEN IN DECIMAL, CORRESPOND TO THE OCTAL STATUS 
CODES IN HELP MSG. 50 

32 - YOUR SAVE-FILE IS NOT LARGE ENOUGH TO CONTAIN THE WHOLE OBJECT 
PROG. 

33 - BINARY PROGRAM BEING SAVED IS NOT IN PROPER FORMAT. ONE OR 
MORE OBJECT RTNS IN THE PROGRAM WERE PROBABLY CREATED BY SOME 
MEANS OTHER THAN TSS-FORTRAN (E.G. GMAP). SYMREFS/SYMDEFS ARE 
NOT COMPATIBLE FOR LINKING WITH TSS-FORTRAN-PRODUCED CODE 

34 - FILE BEING LOADED CONTAINS TOO MANY SUBRTNS. (PRESENT LIMIT IS 
64) 

35 - FILE BEING LOADED IS NOT IN ABSOLUTE FORMAT. WAS PROB. CREATED 
BY SOME MEANS OTHER THAN TSS-FORTRAN 

36 - CKSUM ERROR IN DATA BLOCK(S) OF FILE BEING LOADED 

37 - CKSUM ERROR IN CONTROL BLOCK(S) OF FILE BEING LOADED 

38 - NOT USED 

39 - USER'S ALLOTTED FILE SPACE HAS BEEN EXHAUSTED 

40 - BLOCK~COUNT ERROR WHILE LOADING FILE. DATA BLOCKS ARE OUT OF 
ORDER OR HAVE BEEN DESTROYED 

41 - A FILE REQUESTED FOR LOADING CANNOT BE FOUND AS DESCRIBED 

42 - ILLEGAL FORMAT FOR USER LIBRARY FILE 


057 - RESTRICTED SUBSYSTEM 

THE CENTRAL COMPUTER SITE HAS RESTRICTED THE USE OF THIS SYSTEM, THIS 
MAY BE A TEMPORARY RESTRICTION BECAUSE OF CURRENT LOAD OR A PERMANENT 
RESTRICTION. PLEASE NOTIFY THE CENTRAL COMPUTER SITE FOR FURTHER 
DETAILS. 

<58> ENTRY LOC < 100 

ERROR-MESSAGE 58 EXPLANATION 

THE SUBSYSTEM PROGRAM TO BE EXECUTED DOES NOT HAVE THE INITIAL 100-WORD 
DATA AREA THAT IS REQUIRED OF TSS SUBSYSTEM PROGRAMS. 

<59> FILE filename NOT IN TSS FORMAT 

ERROR-MESSAGE 59 EXPLANATION 

A FORMAT ERROR WAS DETECTED ON THE NAMED FILE. EITHER THE FILE IS NOT A 
TSS-GENERATED FILE, OR A SYSTEM MALFUNCTION HAS OCCURRED. IN THE LATTER 


CASE, REPORT THE CIRCUMSTANCES TO THE CENTRAL COMPUTER SITE, AND RETRY 
THE COMMAND. 
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<60> NO DATA ON FILE filename 

ERROR-MESSAGE 60 EXPLANATION 

THE REQUESTED FILE CONTAINS NO USER'S DATA; THE IMPLICATION IS THAT NO 
DATA HAS BEEN SAVED ON THIS FILE SINCE ITS CREATION. 

<61> LAST SAVE/PURGE COMMAND NOT PROCESSED 

ERROR=-MESSAGE 61 EXPLANATION 

YOUR LAST SAVE, RESAVE, PURGE, OR RUN COMMAND HAS BEEN LOST, PROBABLY 
DUE TO AN INTERVENING EXCEPTION MESSAGE. YOU MAY REISSUE THE COMMAND. 
<62> SAVE FILE filename TRUNCATED. NOT BIG ENOUGH 

ERROR-MESSAGE 62 EXPLANATION 

THE FILE NAMED IN YOUR RESAVE COMMAND IS NOT LARGE ENOUGH (MAX. SIZE) TO 
CONTAIN ALL OF THE CONTENTS OF THE CURRENT FILE. (SOME OF THE CURRENT 
FILE HAS BEEN SAVED.) SUGGEST YOU USE THE SAVE COMMAND WITH A 'NEW' FILE 
NAME, OR MODIFY THE MAXIMUM SIZE OF THE NAMED FILE WITH ACCESS. 

<63> TSS FORTRAN CHAIN ERROR, CODE = nn 


ERROR-MESSAGE 63 EXPLANATION 


YOUR CHAIN LINK COULD NOT BE PROPERLY LOADED. THE REASON CODE GIVEN, IN 


DECIMAL (1-32), CORRESPONDS TO THE OCTAL STATUS CODES IN HELP MESSAGE 
50. 


064 - EXECUTE TIME LIMIT EXCEEDED 


THE PROGRAM TIME LIMIT SPECIFIED BY THE USER AND/OR THE INSTALLATION HAS 
BEEN EXCEEDED BY THE OBJECT PROGRAM. 


065 —- OBJECT PROGRAM SIZE LIMIT EXCEEDED 


THE SIZE OF THE OBJECT PROGRAM HAS EXCEEDED THE INSTALLATION SPECIFIED 
LIMIT. 
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SECTION IV 


TERMINAL USAGE 


GENERAL 


This chapter contains general descriptions of and operational procedures 
for several remote terminals. For complete details pertaining to a 
particular terminal, the user should refer to the instruction manual 
accompanying the terminal unit. 


TELETYPEWRITER/TELEPRINTER OPERATION 


Terminal Applications 


The following types of remote terminals, or their equivalent, may be 
used to communicate with the Time-Sharing System: 


@e Teletype Models 33, 35 and 37 


e@ GE TermiNet 300 


These terminals communicate with the Time-Sharing System via the General 
Remote Terminal Supervisor (GRTS). This interface is described in the 
GRTS Programming Reference Manual. (GRTS was formerly referred to as 
GERTS.) 


When a teleprinter (Model 33, 35 and 37) connects to the system, a 
header message is sent to the terminal. When a teletypewriter connects 
to the system, a carriage return must be given before the header is 
sent. 


These terminals transmit or receive one line of data at a time. The 
number of characters in this line of data may range up to 80 characters 
plus carriage return. When data is being input from the terminal, this 
Carriage return terminates the line of data and initiates the 
transmission of that line of data to the system. 


If the terminal is equipped with a paper tape reader/punch, this device 
may be used for input/output. The input must be formatted the same as 
for keyboard input, but each line must be terminated with carriage 
return, line feed, rubout, rubout. The input tape must be terminated 
with an ASCII X-OFF character. 
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Editing 


Keyboard input is sent to the computer in units of complete lines. A 
line of terminal input is terminated by a carriage return, and no part 
of the line is transmitted to the system until that carriage return is 
given. Therefore, corrections to a line-in-progress (i.e., a partial 
line not yet terminated) can be made. 


A typing error detected before the line is terminated can be corrected 
in one of two ways. He may delete one or more characters from the end of 
the partial line or he may cancel the incomplete line and start over. 
Character or line deletions are effected by means of two special 
characters designated as control characters. These control characters 
may differ between terminals. 


For teleprinter terminals 


character control function 
@(commercial AT sign) character deletion 
CTRL plus X keys line deletion 


For teletypewriter terminals 


character control function 
°(degree symbol or 1/4) character deletion 
+(for 2741) line deletion 
+(for DATEL) line deletion 


Depends on model of the terminal. 
NOTE: Line deletion does not occur until a carriage return is given or 
ATTN (2741) or INT (DATEL) is pressed. 


The editing rules are as follows: 


@e Use of the character-delete control deletes from the line the 
character preceding the deletion character; use of n consecutive 
deletion characters deletes n preceding characters (including 
blanks) up to the beginning of the line. 
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For example: 


*ABCDF E would result in ABCDE being transmitted to the program 
file. 


*ABCKBDEF DEF would result in ABCDEF being transmitted. 
(The characters to be deleted are underlined for illustration.) 
e Use of the line-delete control causes all of a line to be 


deleted. The characters DEL are printed to indicate deletion. 
For example: 


*ACDEFG CTRL/X DEL (all characters deleted; 
carriage return automatic) 
-(ready for new input) 


or 


*ACDEFG (carriage return) 
DEL (all characters deleted) 
-(ready for new input) 
Whereas on the teleprinter terminal the carriage return is 


automatic, it must be given by the user on the teleprinter 
terminal if ATTN or INT is not used. 


The control-character pair for each type of terminal cannot be 
used for other than the deletion function assigned them. 


In AUTOX and AUTO, line numbers and spaces are not deleted. 


Log-On Procedure 


To initiate communication with the Time-Sharing System, the user 
performs the following steps: 

e Turns on the terminal 

@e Obtains a dial-tone on the associated phone-set 

@e Dials one of the numbers of his time-sharing center 
The user will then receive either a busy signal to indicate that the 


line is not presently available or a high-pitched tone -- a "beep" -- to 
indicate that his terminal has been connected to the computer. 
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Once the user's terminal has been connected to the computer, the 
Time-Sharing System begins a log-on procedure. Initially, the header 
message is transmitted: 


HIS Series 6000, Series 600 ON date AT time CHANNEL nnnn 


where time is given in hours and thousandths of hours (hh.hhh), and nnnn 
is the user's channel number. This is the standard message, however’ the 
user site may put in a message of its own. 


Following this message, the system asks for the user's identification: 


USER ID - 


The user responds, on the same line, with the user-id assigned to him by 
the time-sharing installation management. This user-ID uniquely 
identifies a particular user already known to the system. This ID is 
used to locate his programs and files, and accounting for his usage of 
the time-sharing resources allocated to him. An example request and 
response might be: 


USER ID -J.P.JONES 


Note 


User's responses are underlined for illustrative 
purposes. 


A carriage return must be given following any complete response, 
command, or line of information typed by the user. If a charge number is 


also required for accounting purposes, the user can supply it as 
follows: 


USER ID -J.P.JONES;12345675E 


The charge number may consist of from 1 to 12 alphanumeric characters, 
separated from the user-id by a semicolon. (Refer to NEWUSER command 
description in Section III.) 


After the user responds with his user-ID, the system asks for’ the 
Sign-on password that was assigned to him along with his user-ID as 
follows: 


PASSWORD-- 
BRZRWHRRE RSS 
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The user types his password directly on the "strikeover" mask provided 
below the request PASSWORD. The password is used by the system as a 
check on the legitimacy of the named user. (In the event that either the 
user-ID or password is given incorrectly two consecutive times, the 
user's terminal is immediately disconnected from the system.) 


At this point, if the accumulated charges for the user's past 
time-sharing usage equals or exceeds one hundred percent of his current 
resource allocation, he will receive a warning message: 


RESOURCES OVERDRAWN n 


If his accumulated charges exceeds one hundred and ten percent of his 
current resources, he receives the following message and is immediately 
disconnected. 


RESOURCES EXHAUSTED - CANNOT ACCEPT YOU 


If the user's file space is greater than 88 percent used, he receives 
the following information message: 


n BLOCKS FILE SPACE AVAILABLE 


The number n specifies the number of 320-word blocks of unused file 
space for this user. This does not affect the log-on procedure, and the 
user is permitted to continue. 


When the user has been validated, the Time-Sharing System asks him to 
select the subsystem that he wants. This is called the 
Subsystem-selection request, and is done by the system sending the 
following inquiry to the terminal: 


SYSTEM? 


The terminal user must respond with the name of the desired subsystem. 


Major subsystems -- i.e., BASIC, FORTRAN, EDITOR, and CARDIN -- all 
provide a file-building facility, called BUILD mode. In BUILD mode, the 
user is free to enter either file-building input or control commands, as 
he chooses. All other subsystems begin directly with a 
question/response dialogue between the subsystem and the user that is 
unique for each subsystem. 


a= BSOL 


For example, suppose the user decides to work with the BASIC subsystem 
(the subsequent log-on sequence is representative for any of the major 
subsystems) : 


SYSTEM? BASIC 


NOTE: A carriage return terminating each separate user response is 
assumed to be understood. The underlining indicates the user's 
response. 


Having selected the BASIC subsystem, the user is asked whether he now 
wants to Start a new file -- 1.e., a new program in the case of BASIC -- 
or wants to retrieve and work with a previously entered and saved file 
or program. The request message is 


OLD OR NEW - 


If the user wishes to start a new program (1i.e., build a new source 
file), he responds simply with 


NEW or N 


If, on the other hand, he wants to recall an old source file, he 
responds with 


OLD filename or O filename 


where filename is the name of the file on which the old program was 
saved during a previous session at the terminal (refer to the SAVE and 
RESAVE command descriptions in Section II). 


Following either response, the subsystem types the message READY and 
returns the carriage. If the subsystem to be used is BASIC, FORTRAN or 
CARDIN, an asterisk is printed in the first character position of the 
next line. If Text Editor is the subsystem to be used, one of the 
following may occur: 


1. If the user starts with a new program, the READY message is 
given, then the message ENTER is printed, followed by an 
asterisk in the first character position of the next line. 


2. If the user recalls an old source file, only the READY message 
and carriage return are given, and the user is in the EDIT mode 
of Text Editor. To go to the BUILD mode, the user must respond 
with the command BUILD. Then the ENTER message 1s typed, the 
carriage is returned, and the asterisk is typed. 
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The following is an example of a complete log-on procedure, up to the 
point where the BASIC subsystem is ready to accept file building, 
correction input, or control commands: 


HIS SERIES 6000, SERIES 600 ON 07/26/69 AT 14.768 CHANNEL 0012 


USER ID -J.P. JONES 

PASSWORD 

ARE BEKRHXXKE 

SYSTEM ?BASIC 

OLD or NEW-NEW (NEW is shown arbitrarily for illustration) 
READY coe 

* - (the user begins entering input on this line) 


Entering BUILD-Mode Input 


After the message READY, (for Text Editor ENTER) the subsystem is in 
BUILD mode (as indicated by by the initial asterisk). It is ready to 
accept program statement or text input, depending upon the _ selected 
subsystem and/or command language. All lines of input other’ than 
commands are accumulated on the user's current file. This is normally 
the file that contains the program or text he wants to work with. If he 
is building a new file (NEW or N response to OLD OR NEW-), his current 
file will initially be empty. 


If he has recalled an old file (OLD or O filename) the content of the 
named old file will initially be on his current file. Any input (except 
control commands) will, in a line number dependent subsystem, either be 
added to, merged into, or replace lines in the current file, depending 
upon the relative line numbering of the lines in the file and the new 
input. (Refer to Correction or Modification of Line Numbered Files). In 
a nonline-number dependent subsystem (Text EDITOR for example) any new 
input is appended to the file. 


Following each line of noncommand-language input and terminating 
carriage return, the subsystem supplies an initial asterisk, indicating 
that it is ready to accept more input. In the case of command language 
input, the subsystem normally returns to BUILD mode following execution 
of the process requested by the command. 


In line-number dependent subsystems (BASIC, FORTRAN, CARDIN), a line of 
file building input must begin with a line number of from one to eight 
numeric characters. This number may optionally be preceded by one or 
more initial blanks. The line number facilitates correction and 
modification of the source program. The line number is always 
terminated, (i.e., immediately followed) by a non-numeric’ character, 
which may be a blank. 


In nonline-number dependent subsystems, a line of file building input 
may begin with any sequence of characters that is not defined as command 
language for the subsystem being used. 
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Correction or Modification of Line-Numbered Files 


The correction or modification of the current file in line-~number 
dependent subsystems proceeds according to the following rules: 


@ Replacement: a numbered line will replace any identically 
numbered line that was previously typed or already contained on 
the current file; i.e., the last entered line numbered nnn will 
be the only line numbered nnn in the file. 


@e Deletion: a line consisting of a line number only, (i.e., nnn), 
will cause the deletion of any identically numbered line that 


was previously typed or is already contained on the current 
file. 


e Insertion: a line with a line number value that falls between 
the line number values of two pre-existing lines will be 
inserted in the file between those two lines. 


At any point in the process of entering file building input in 
line-numbered subsystems, the LIST command may be given, which results 
in a clean, up-to-date copy of the current file being printed. In this 
way, the results of any previous corrections or modifications can be 
verified visually. (The several forms of the LIST command are described 
in detail in Section III.) Following the command OLD filename, the LIST 
command can be used initially to inspect the contents o the current 
source file, i.e., the "old" program. 


Automatic Terminal Disconnections 


Once communication with the Time-Sharing System has been established, 
any question or request must be answered within ten minutes. If these 
time limits are exceeded, the user's terminal will be disconnected. 


Log-Off Procedure 


To terminate one's current session with the Time-Sharing System and 
disconnect the terminal, the BYE command may be given either in BUILD 
mode or at the subsystem-selection level: 


“BYE 
or 
SYSTEM?BYE 
or 


SYSTEM? LOGOFF 
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In either case, a report of the user's time-sharing usage charges is 
given, as illustrated by the following example, and the terminal is 
disconnected: 


** RESOURCES USED $ 4.47, USED TO DATE $ 919.02= 92 


**TIME SHARING OFF AT 12.655 ON 11/04/69 


When operating under a subsystem that does not have a BUILD mode and 
does not recognize BYE aS a response, the response DONE may be used. BYE 
may then be given at the resulting subsystem-selection level. 


To terminate the current session without disconnecting the terminal, the 
command NEWUSER may be given in place of BYE. This’ procedure allows 
another user to log-on immediately following. The current user's log-off 
report is then printed and a new log-on sequence is initiated. NEWUSER 
may also be used to change the charge number, but without going through 
the LOG OFF/LOG ON procedure. 


Terminating an Output Process 


A lengthy listing or other output of information at the terminal, 
initiated for example by a LIST command, may be prematurely terminated 
by the use of the interrupt control peculiar to the type of terminal in 
use. This interrupt control is as follows: 


e For teletypewriter terminals -- the BREAK key 


e For typewriter-like terminals -- the ATTN or INT key 


This control can also be used for abnormal termination of a program 
execution. However, the user is cautioned against indiScriminate use of 
this control since the results of its use are in some cases 
unpredicatable (in regard to the status of files, for example). The 
subsystem will normally return to BUILD mode or to the _ subsystem 
selection level following the use of an interrupt control. 


Paper Tape Input in BUILD Mode 


In order to supply file-building input from paper tape, the user gives 
the command TAPE (#TAP if the subsystem is Text Editor). The subsystem 
responds with READY. If the tape reader is ready, it will be turned on 
automatically. If it is not ready, the user should position his tape in 
the tape reader and start the device. Input is terminated when an X-OFF 
character is read by the paper tape reader, or the tape is stopped and 
the user types X-OFF. 
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The tape may be prepared off-line from the keyboard, or it may be the 
result of previous output punched by the paper tape unit. If prepared 
off-line, it should include carriage returns to terminate each line, 
just as if entering data on-line, plus explicit line feeds to obtain 
legibility on the terminal printer during preparation and transmission. 
The carriage return and line feed must be followed by two rubout 
characters for terminal timing considerations. 


Command language may not be included on the tape. The input should be 
preceded by several RUBOUT characters and terminated by an XOFF followed 
by several RUBOUT characters. Neither the XOFF nor the RUBOUT 
characters will appear in the file. 


As with keyboard input, a maximum of 80 characters is permitted per line 
of paper tape input. Excessive lines will be truncated at 80 
characters, with the remaining data placed in the next line. A maximum 
of two disk links (7680 words) of paper tape input will be collected 
during a single input procedure, except in LUCID mode, which has a limit 
of six links. All data in excess of two disk links will be lost. 


Building File from Non-ASCII Paper Tape 


In order to supply file building input from non-ASCII paper tape 
(unaltered eight-bit codes), the user gives the command LUCID instead of 
TAPE. The system will read in the tape and store the data on ae file 
without editing or parity modifications. The system does not delete or 
act on any characters in the data stream, such as DEL, X-OFF, CR, etc. 
The input will be terminated when a pause of over one second occurs in 
the data transmission. Termination does not require an X-OFF character, 
as does normal paper tape input via a DATANET 355 Communications 
Processor. 


NOTE: LUCID cannot be used if data communication is via a Low 
Speed Line Adapter (LSLA) on a DATANET 355. 


During paper tape input via a DATANET 355, the paper tape input will 
stop when an error message is to be sent to the terminal. 


Automatic Paper Tape Input 


At any point during the operation of the Time-Sharing System and at a 
time when the user must supply keyboard input, a previously prepared 
paper tape in special format may be used to simulate a sequence of 
responses, one line at a time. The system need not be in BUILD mode and 
direct (i.e., conversational) responses, file building input, and/or 
commands may be entered. 
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This feature allows the preparation of a paper tape for input to the 
Time-Sharing System and/or subsystem(s) prior to connection with the 
system and allows terminal operation without supervision during the 
connection. Such paper tape input may be for a specific subsystem or 
production program execution only, or may include anything from log-on 
through log-off procedures. Obviously such a tape must be error free. 


The required format for each input line is as follows: 


data string (up to 80 characters) 

carriage return 

XOFF 

RUBOUT (may be multiple, but one is minimum requirement) 


Character-delete control characters may be used in the normal fashion. 
Line-delete controls must be used as follows: 


data string (to be deleted) 
(line-delete control) 

XOFF 

RUBOUT (one is minimum) 
corrected data string 
carriage return 

XOFF 

RUBOUT 


NOTE: Parity errors encountered during paper tape input may cause the 
terminal to be disconnected. 


It is suggested that extraneous line feeds not be included in the tape. 
If, however, the user desires line feeds for terminal printer 
legibility, they should be either between the data string and carriage 
return, or one line feed immediately following XOFF. 


To initiate automatic paper tape input, the user merely need position 
the tape and start the reader at any time that keyboard input is 
required. 


The terminal is automatically disconnected if no input is received 
within 10 minutes of the request for such input, whether via paper tape 
or keyboard. 
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KEYBOARD/DISPLAY TERMINAL OPERATION 


General Characteristics 


The keyboard-display terminals (DATANETL 760, VIP765 and VIP775) are 
cathode ray tube display plus keyboard devices. A complete page (screen) 
of input may be composed before transmission to the Time-Sharing System, 
and a complete page of output may be displayed. The page may consist of 
up to 26 lines of data for a DATANET 760 or 22 lines for VIP765 or 


VIP775. Each line contains a maximum of 46 characters. (The 46-character 
line is equivalent to the 70- to 80- character line allowed by the 
teletypewriter and typewriter-like terminals, insofar as a "line" is 


defined by the Time-Sharing System.) 


The keyboard-display terminal consists of two elements, the keyboard 
module and the CRT display module. The keyboard module is a= physically 
separate unit from the display module. The standard cable length 
provided between keyboard and display modules is four feet; however, for 
special applications the cable distance may be up to 100 feet. 


The AUTOMATIC command cannot be used with these terminals. 


Operation of the keyboard-display terminal differs essentially from 
keyboard/printer types of terminals as follows: 


e@e More than one line of data may be transmitted to or received 
from the system at one time. 


@e Special character-delete and line-delete control characters are 
not applicable, as all typing errors may be corrected by means 
of controls inherent in the keyboard-display terminal. 


The user enters data by typing on the keyboard as on a typewriter. The 
characters and symbols are instantaneously displayed as they are typed. 
A special entry marker appears on the display to indicate the location 
of the next character to be entered. The marker automatically indexes 
with each character entry or may be manually spaced forward or backward, 
and up or down. It may also be reset to the first character position of 
the page or line. In addition to providing repetitive character entry 
capability, a repeat key allows a continuous Scanning movement of the 
marker. Changes or corrections are made by relocating the marker to’ the 
erroneous character and typing the correct one. Erasure of the entire 
display is accomplished by a Form Feed key. 


1trademark 
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A TAB key allows the user to quickly and efficiently enter information 
into an user-composed or computer-stored format. Pressing the TAB key 
causes the entry marker to scan the display until it finds a vertical 
line, where it stops. These vertical lines, which serve as tab-stop 
markers, can be positioned anywhere on the display surface by the user 
or the computer. 


The user completes the composing, verifying and correction of the entry 
with the terminal off-line. When satisfied that the information is 
correct, the user positions the "end of text" symbol (C) opposite the 
last line of characters to be transmitted; then returns the entry marker 
to the first character to be sent; and presses the transmit key. 
Successive characters are transmitted up to the "end of text" symbol. 


Keyboard Module 


The keyboard module contains a standard alphanumeric key group and a 
command key group. Additional key groups are available as options. 


Alphanumeric Key Group 


ALPHANUMERIC KEYS 


The alphanumeric character-set contains upper case alphabetic 
characters, numerics 0-9, and special characters. The commonly’ used 
ASCII special characters are all present except the t (up-arrow) 


character, generally used to denote exponentiation in algebraic 
subsystems. The up-arrow is replaced by the BLK (blink) character for 
such subsystems. 


The following keys cause the entry and display of a corresponding 
character with a single key action. 


Key Label and Character Displayed 


A H O V 2 9 
B ai P W 3 

e J Q x 4 ; 
D K R Y 5 j 
E L Ss Zz 6 ~ 
F M 4 0 7 J 
G N U ng 8 : 


The space bar erases any character under the entry marker, displays a 
blank space, and moves the entry marker one space forward. 
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The following characters are generated by using the SHIFT key in 
conjunction with the designated key. 


Key Label and Character Displayed 


: & + @ 
" ' < rare 
# ( = i 
$ ) > | 
% * . | 


The BLK (blink) key initiates the blink code (displayed as a space), 
causing the blinking of all following symbols up to the first space or 
up to and including character position 46. 


The RPT key is used to repeat an alphanumeric key operation as long as 
the RPT key is pressed. 


CONTROL KEYS 
Control keys for the manipulation of the entry marker are as follows: 
Key Label Operation 


BS Backspace entry marker one space. If entry marker is in 
character position 1 of a line, pressing the BS key 
will not affect the entry marker position. 


FS Forward space entry marker one space. 

LF or 

LINE FEED Line Feed - Moves entry marker down one line at the 
same character position. If the entry marker is 


initially located on the last line of the display, it 
will automatically return to the top line. 


ETX End of Text - Positions ETX symbol (C) at end of the 
line on which the entry marker is located. 


RLF Reverse Line Feed - Moves entry marker up one line at 
the same character position. If entry marker is on 
first line, RLF key will not affect the entry marker 
position. 
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LR or 
RETURN 


FF or 
FORM 


TAB 


NEW LINE 


Line Return - Moves entry marker to first character 
position of the same line. 


Form Feed (clear display) - Erases the entire display 
except for the mode character, ETX symbol (C) and_ the 
optional function characters, This command also 


automatically restores the entry marker. 


Moves entry marker from its initial position to _ the 
character position following the next vertical line 
symbol. If the entry marker reaches the end of a page 
before a vertical line is found, the entry marker will 
return to the beginning of the page. 


Moves entry marker to first character position on _ the 
next line. If the entry marker reaches the last line, 
it will return to the first character position of the 
top line. 


Command Key Group 


Command keys for the manipulation of data are as follows: 


Key Label 


PRT 


LOC 


Operation 


Print - Causes the information displayed to be 
transmitted to the computer with a print request 
Character in the message header. Symbol P appears in 
mode display position when the PRT key is pressed, and 
keyboard entry is prevented until the message transfer 
is complete. The entry marker is moved to the first 
character position of the line following the ETX symbol 
(C) when the information transfer is complete. If the 
ETX symbol is on the last line of the page, the entry 
marker is moved to the first character position of the 
first line. 


Local - Allows entry of data from the keyboard only. 
Symbol L appears in the mode display position when 
local operation is selected. 


Receive - Allows the computer to enter or update the 
display at any time. Entry of data from the keyboard is 
also allowed. The symbol R is displayed in the mode 
display position when RFC operation is selected. 
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TX Transmit - On input, requests transmission of the 
message to the computer. During output, requests 
another page of data to overlay that already on the 
display. When transmission is requested, keyboard entry 
is prevented until the transmission is completed. The 
symbol T appears in the mode display position when the 
TX key is pressed, and the entry marker is positioned 
on the line following the ETX symbol (C) when 
transmission is complete. If the ETX symbol is on the 
last line of the page, the entry marker is moved to the 
first character position of the first line. 


- Backspaces entry marker one space. Repeated if held 
down. If entry marker is in character position 1 of a 
line, pressing will not affect the entry marker 
position. 


ad Forward spaces entry marker one space. Repeated if held 
down. 

4 Line Feed - Moves entry marker down one line at _ the 
same character position. If the entry marker is 


initially located on the last line of the format, it 
will automatically return to the top line. (Repeated if 
held down.) 


t Reverse Line Feed - Moves entry marker up one line at 
the same character position. When the entry marker 
reaches the top line of the display, the Reverse Line 
Feed operation has no effect. (Repeated if held down.) 


PR Page Return - Returns entry marker to the first 
character position on the first line. 


ETX End of Text - Positions ETX symbol (C) on display at 
end of line on which the entry marker appears. 


Mode Indicator and End-of-Text Symbol Positions 


ia Indicator 


Qe eee ae) 


ETX (End of Text) Symbol 
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Mode 
Indicator Meanin 


T Indicates that the transmit (TX) key has been pressed 
and that the computer generated acknowledgment message 
has not yet been received by the terminal. 


blinking mode 
indicator Indicates that an error was recorded during the last 
message transmitted from computer to terminal. 


P Indicates that the print (PRT) key has been pressed and 
that the computer generated acknowledgment message has 
not yet been received by the terminal. 


L Indicates that the local (LOC) key has been pressed, 
Placing the terminal in off-line compose mode. 


R Indicates that the receive (REC) key has been pressed, 
placing the terminal in receive mode. 


The position of the ETX symbol (C) is varied vertically in the right 
margin of the display by means of the ETX key. The symbol is positioned 
by the user to the last line of text to be transmitted, this last line 
being indicated by the entry marker positioned over some _ character 
within the line. 


Display Module 


The display module is a viewing device for use during composition and 
editing of information prior to transmission of data and for display of 
data received from the computer. 


The entry marker, a blinking horizontal line at the top of a character 
position, always indicates where the next typed character will appear. 
The user may position this marker as follows: 


1. FF - Form Feed clears the display and moves the entry marker to 
the upper left corner (first character position). 


2. Use of alphanumeric keys moves the entry marker to the next 
position on the display. LR key moves the marker to the left 
side of the display, LF key moves the entry marker down one 
line. 
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Sif . os (right arrow) key moves the display entry marker to the 


FLOR. 

= (left arrow) key moves the marker to the left. 

t (up arrow) key moves the marker towards the top of the 
display and the 4(down arrow) key moves the marker towards 


the bottom of the display. 


4. The PR key moves the entry marker to the upper left corner of 
the display. 


The display may be cleared by pressing the FF key. Characters may be 
changed by positioning the entry marker and entering a replacement -- 
Character key or the space bar (blank). 


A keyboard display terminal has three modes: local, receive, or 
transmit, indicated by an L, R, or T in the upper left corner of the 
display. The user may compose input in local or receive mode (when the 
keyboard is unlocked). When ready to transmit, the user must execute the 
following three steps. 


1. Position the ETX symbol (C) -- on the right margin of the 
display -- to the last line of input to be transmitted by 
positioning the entry marker on the last line (any character 


position) and striking the ETX key. 


2. Position the entry marker on the first character to be 
transmitted. Full lines (46 characters + CR + LF) are always 
transmitted except for the first line if the user positions the 
marker in other than the first position. 


3. Strike the TX key. The mode indicator will change to T then to 
R when transmission is successful. If the mode indicator 
blinks, it is an indication that an error was recorded during 
the last message transmitted from the computer. 


To respond to the blinking asterisk below last line of text (when ready 
for the next page), strike the EXT key and PRT or TX key. The use of the 
PRT key results in a clearing of the display before the appearance of 
new text. The use of the TX key results in the overlaying of old text 
(already on the display) by the new text. When the PRT or TX keys. are 
pressed, the mode character at the upper left corner of the display 
indicates whether or not the function was performed. 
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Log-On, Log-Off, Break, and Disconnection Procedures 


LOG-ON AND LOG-OFF 
The log-on procedure for the keyboard-display terminal is as follows: 


e Turn the unit on by means of the ON/OFF switch and wait 
approximately 30 seconds for warm-up. The mode indicator, ETX 
symbol, and the entry marker will appear on the display. 


e Enter and transmit the following log-on request message: 
$*Sab passwd,nn,DAC,TSS 


Where: ab - Two-character (alpha character) station code. 


passwd - Password. 
nn - Page size in number of lines per page (04,08,16,22 
or 26), 


The Time-Sharing System normally responds with the same log-on sequence 
as on teletypewriter terminals. The user's log-on responses are also 
standard. 


The log-off procedure is also exactly as for other terminals. Note, 
however, that unlike teletypewriter terminals, the keyboard-display 
terminal must be turned off manually following disconnection. 


BREAK AND DISCONNECTION 


A "BREAK" (interrupt) signal is transmitted to the system by means of 
the following control message: 


$ *SBRK 


This message can be used to interrupt some lengthy output process, such 
as the unwanted remainder of a long listing, or to interrupt execution 
of a user's program. 
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Under circumstances where it might be necessary to force a 
keyboard-display terminal to disconnect from the system, the following 
message should be composed and transmitted: 


S$*SDIS 


Following the disconnect, the log-on request message may again be 
transmitted. 


Exceptions to Standard Subsystem Usage 


Exceptions to standard subsystem usage as a result of operating with a 
keyboard-display terminal are as follows: 


e In using the Text Editor subsystem, the first column, carriage 
return escape command effecting the change from BUILD mode _ to 
editing mode, is replaced by a double pound sign (##). 


@ In BUILD mode of line-numbered files, a line number followed by 
a double pound sign (##) only indicates a delete of the line 
designated by the line number. 


e With the use of algebraic subsystems BASIC and ABACUS, the 
up-arrow (t) symbol used as the exponentiation operator is 
replaced by a BLK (blink) character preceding the exponent. The 
blink character itself is displayed as a blank, and causes’ the 
exponent character(s) following the blank, in turn, to blink. 


@® Output on the screen will be by page; that is, when a_ subsystem 
fills a page (4, 8, 16, 22, or 26 lines), the output halts until 
the user presses the PRT button. A blinking asterisk is the 


Signal for a response. To receive the next page, the response 
should be: 


1. ETX-TX to transmit the data delineated by the entry marker 
and EXT, 
2. ETX-PRT to clear the screen first. 


The ground rules for the counting of lines are: 


l. Lines >46 characters are continued on the next line. No 
attempt is made to break at word boundaries. 


2. A last line on the page >46 characters will be reserved so 
that the entire line will appear at the beginning of the 
next page. 
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3. Counting of input lines (carriage return and line _ feed 
following a request counts one line) is ignored under the 
assumption that the current systems can use only one _ line 
(already counted) and specific keyboard-display terminals 
applications will count, FF, ETC, internally. 


The automatic line numbering mode (command AUTO) is inoperable 
from a keyboard-display terminal. 


Files built by a keyboard~display terminal have lines limited to 
46 characters. A line may not be made longer by "wrapping" to 
the next line as is done when outputting files build on another 
terminal with longer lines. 
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SECTION V 


SERVICE SUBSYSTEMS AND PROGRAMS 


ABACUS SUBSYSTEM 


The ABACUS (ABC) subsystem is an algebraic-expression evaluator that may 
be called either at the subsystem selection level or at the command 
language level. The function of ABACUS is that of a powerful desk 
calculator, with the ability to calculate and remember the value of 
symbolic variables. It also features summation operation and employs 
commonly used mathematical constants and functions. 


Use of ABACUS 


SYSTEM ?ABC (if at subsystem selection level) 
or 


* ABC (if at command level) 


——— 


The initial call (SYSTEM? or command level) may contain, on the same 
line, the expression to be evaluated; e.g., *ABC 1.379 2. Otherwise, 


ABACUS issues a question mark (?) as a request for input. The possible 
forms of input are: 


? expression 


? xX = expression where x is a variable 
? FOR x = a,b,c; where a,b,c specify a 
expression in x range of values for x 
? FOR x = a,b,c; where y is also a 
y = expression in x variable 


From one to three FOR specifications may be employed before the 
expression, separated by semicolons; i.e., FOR x = ...; FOR y = ...; FOR 


Z = eeese 


The results of each expression evaluation are printed immediately. 
ABACUS then issues another request for input (?). A null response 
(.1.e., carriage return only) or DONE causes an exit from the subsystem. 
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An expression is composed of operators, numbers and/or variables, and/or 
constants and functions, conforming to ordinary arithmetic and algebraic 
rules. The permissible operators are: 


(addition) 
(subtraction) 
(multiplication) 
(division) 
(exponentiation) 
(summation) 


Dae #1 + 


Parentheses may be used to indicate grouping of operations, according to 
standard usage. 


Numbers 
Numbers may be written as: 


Integers: e.g., 1, -25, 7063 

Fractions: e.g., .l, -.0005, .3681400 

Mixed numbers: e.g., 1.5, 812.764 

Scientific notation: e.g., 1E10, 2.41E-3, -3215E7 


Numeric operands may contain up to 18 significant digits. Printed result 
values are limited to a maximum of seven places in the fractional part. 
Precision is kept internally to 18 places, however. 


Variables 


Variables (names to which numeric values can be assigned) are composed 
of one to eight alphanumeric characters, the first of which must be 
alphabetic; e.g., A, B5, SUMSQUAR. There are two types of variables, 
according to usage: (1) FOR variables, i.e., those defined in a FOR 
specification, and (2) label variables; these appear on the left of an 
equal sign but not preceded by FOR. In input of the form "X = 
expression", X is a label variable. The distinction to be noted between 
the two types is that label variable values are remembered between 
expression evaluations. The values assigned to a FOR variable hold only 
for the expression associated with the FOR specification(s); they are 
not remembered for a subsequent expression. For example: 


? X = SIN (30/RADIAN) (X is a label variable) 
X = +0.5 - (answer) 

? X 2*27.9 

+6.975 - (answer) 
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Constants and Functions 


Constants and functions available in ABACUS are: 


Constant Name Predefined Value 
PI 3% 14159.%% 
RADIAN Dil ee Vous anes internal precision to 
E 2071828 sx 18 significant digits 
Function Name Meaning 
ABS (x) Absolute value of x 
ATTN (x) Arctangent of x 
COS (x) Cosine of x 
EXP (x) e to the power of x 
LOG (x) Natural logarithm of x 
SIN (x) Sine of x 
SQR_ (x) 
or } Square root of x 
SOT (x) 
TAN (x) Tangent of x 


For trigonometric functions, x denotes an angle measured in radians. 


Function names are reserved words; i.e., they cannot be used as variable 
names. Constant names are not reserved; actually they are remembered 
variables with preset values. Their value may be changed by using the 
name as a label variable. 


Summation Operator and FOR Variables 


The summation operator, &, may only appear at the beginning of an 
expression, and the entire portion of the expression following it is 
assumed to be the argument to be summed (regardless of the use of 
parentheses). From one to three variables may be given a range of values 
for the summation by means of FOR statements. 


The FOR statement(s) must precede the associated expression in the same 
line of input, separated by semicolons. The form of the FOR statement 
is: 


FOR x = a, b, c; 
Where: a - Initial value of x. 


b - Limiting value of x. 
c - Step value or increment (optional). 
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If the step value, c, is not specified, 1 is assumed. Substitutions for 
a, b, and c may be positive or negative integers, expressions, or 
predefined variables, , 


For example: 


? FOR X = 1, 5; FOR Y = 7, 50,9; Z = &(X+Y)*PI 
Z = 2199.1149 


In summations, all FOR variables are treated as summation indices and in 
the case of summations over two or three FOR variables, the indicated 
summations are nested. Each summation variable takes on the values a, 
a+c, at2c,...up to but not exceeding the value b. Thus the expression 
above would expand as follows: 


5 43 
= z > (X+Y) 
MSM 2 pees Y=7,16,... 
Z= ((1+7)7 + (14+16)7 + (1425)7 +...4+(54+34)7 + (54+43)77) 


Although an expression containing a summation operator must be preceded 
by one or more FOR specifications (in order to be meaningful), FOR 
variables may also be used in expressions that do not contain the & 
operator. For example: 


2: PORTA = S541 23 FOR 3 = 1,37 2 =e. “8B 
In these cases, the expression will be evaluated separately for each 


possible combination of FOR values (as is done in FORTRAN). The output 
from the example expression just above would appear as: 


os 
[wo 
[>< 


3 al. 3 
3 2 9 
3 3 27 
5 1 5 
5 2 25 
5 3 125 
a 1 | 
7 2 49 
7 3 343 
9 1 9 
9 2 81 
9 3 729 
Py 1 11 
lee 2 121 
ey: 3 L331 
If a label variable is used, as in the above example (X), the last 


determined value is remembered for the variable. 
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Continuation Lines 


ABACUS accepts only one expression at a time, with or without associated 
FOR specifications. Normally, this is represented on one line of 
terminal input. If, however, the expression (with any preceding FOR 
specifications) requires more than one line, the first line can be 
terminated with a $ plus carriage return combination--rather than a 
carriage return only. This denotes the next line to be continuation of 
the first, and ABACUS responds with another input request (?). 


Order of Evaluation and Use of Parentheses 


Expressions are evaluated from left to right, with operations performed 
in the following order: 


i% functions 
Zs t 

34 * and / 
4. + and - 
Bs & 


Care must be exercised, especially with regard to successive 
exponentiation, to ensure that the order of evaluation implied by the 
above rules is the order intended. If the intention is otherwise, 


parentheses must be used to force the desired order of evaluati 


All operations within a subexpression enclosed in parentheses will be 
performed before any operations to the right of that subexpression. 
Grouping of operations to any depth may be indicated by means of nested 
sets of parentheses. An exception is the summation operator, &, which 
may not be enclosed in parentheses. 


Implicit multiplication is allowed preceding a parenthesized 
subexpression, but not between two such subexpressions. For example: 
3(x) is equivalent to 3*(x); but (x) (y) is illegal, and must be written 
as Ax) * fy) 


The argument of a function, which may be any expression, must be 
enclosed in parentheses. 
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Mode and Precision of Calculation 


All calculations are performed in double precision floating-point, with 


consequent precision (but not accuracy, necessarily) to 18 places. 
Displayed results are limited to a maximum of seven places in the 
fractional part (rounded), but 18 significant digits are carried 


internally. This may result in a small discrepancy between displayed 
intermediate and final results, in a sequence of related evaluations. 


ASCII-TO-ASCII CONVERSION SUBSYSTEM 


ASCASC Subsystem/Command 


The Series 6000 FORTRAN, TSS ALGOL and TSS JOVIAL language systems 
require the following translations between the time-sharing format ASCII 
data files (type 5) and the standard system format ASCII data files 
(type 6): 


@e Time-sharing format ASCII files may be converted to a_ standard 
system format ASCII files to be used as input data for Series 
6000 FORTRAN, TSS ALGOL, and TSS JOVIAL. 


e Standard system format ASCII files must be converted LO 
time-sharing format ASCII files which can be listed at a 
terminal. 


The ASCASC subsystem performs these translations. ASCASC may be called 
at the subsystem selection level or at the command level at the BUILD 


input level of the language system requiring the translation. The format 
of ASCASC is as follows: 


ASCASC filedescr 1; filedescr 2 
Where: filedescr 1 - Input file to be converted 


filedescr 2 - Output file to be created 
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Execution 


In the execution of the ASCASC command, the input file is read and 
converted to the format required for the output file. The input file's 
record control word is checked to determine the format of the file. If 
the logical record type is type 5, the file is in time-sharing ASCII 
format. If the logical record type is type 6, the file is in standard 
system ASCII format. Based on this determination, one of the following 
translations is performed: 


1. If the input file is in time-sharing ASCII format 
(character-oriented file), the characters in the file are read 
and converted to the word-oriented standard system ASCII format 
for the output file. 


2. If the input file is in standard system ASCII format, the words 
in the file are read and converted to the time-sharing ASCII 
format for the output file. Up to 72 characters will be 
converted. 


If neither logical record type 5 or type 6 is found in the record 
control word, a message is sent to the user to tell him that the file he 
specified is not an ASCII file. 


Question/Answer Sequence 


The question and answer sequence for ASCASC depends on the type of input 
file to be translated. 


If the input file is in time-sharing ASCII format, the question and 
answer sequence begins with the LABELS? question. The response may be 
one of the following: 


e STRIP - Line numbers in the input file-are to be stripped from 
each line before conversion to output file format. When 
STRIP is used, the first nonnumeric character of a 
terminal line (if not a tab) goes to column 1 of the 
line. 


e ASIS - Input file is to be passed to the conversion processing, 
as it exists. In this case, each line will be converted 
to standard system ASCII format for the output file. The 
use of ASIS inplies that the file does not contain 
initial line numbers or that the line numbers are to 
appear in the output file. 


e NORM - This response implies that the STRIP option and the 


standard tab character (colon) and settings 
(1.6.57 4) 84167324.73) are’ an-the tite, 
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If the response to LABELS? was not NORM, the question TAB CHARACTER AND 
SETTINGS? is asked. The response may be one of the following: 


e Carriage return (null response) - This response indicates that 
no tab characters are in the file, 


e t,sl,s2,...,83 - This response indicates that a single tab 
character (t) and a group of tab settings (sn) have been 
used. The value of si must be less than 81. 


@e tab-set 1; tab-set 2;...; tab-set n - This response indicates 
that multiple groups of tab Character and tab settings are 
used in the file. Tab-set i has the same form as the single 
tab character and settings. 


If the input file is in standard system ASCII format, the question LINE 
NUMBERS? is asked. This question requests information concerning line 
numbering in the output file. One of the following responses may be 
given: 


e AUTO - Line numbers are to be generated for the output file 
beginning with 10 and incrementing by 10. 


e AUTO n, m - Line numbers are to be generated for the output file 
beginning with n and incrementing by m. 


@® carriage return - Null response, nothing changes. 


FILE SYSTEM 


The Series 6000 Time-Sharing System utilizes the capabilities of the 
GCOS file system, which is a logical mechanism for storing and 
retrieving permanent files and is common to all system programs 
operating under the Comprehensive Operating Supervisor (GCOS). A _ file 
system can store many files on many unspecified external, background 
storage devices, and the user normally need not be concerned with the 
device his file is on nor with the characteristics of the device, 


File System Structure 


The file system is described in detail in the GCOS File System reference 
manual. However, the main features of interest to the time-sharing user 
are repeated here. 
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The file system is a tree structure whose origin is the system master 
catalog. The primary nodes of the tree are user's master catalogs; the 
lower level nodes are subcatalogs created by the user. The terminal 
points of the structure are the files themselves. The file system has a 
limit of seven levels for either building or accessing files. Figure 5-1 
shows the file system's hierarchical structure. 


Catalogs and Files 


A catalog consists of a definition containing a catalog name, password, 
and permissions. Since it contains no user data, a catalog can be 
neither read nor written except by the file system itself. An ACCESS 
function is provided, however, to direct the file system in the creation 
and modification of subcatalogs. 


A file, as known to the GCOS file system, consists of a definition 
containing file name, file size, password, permissions, and a 
description of the physical file space. The file definition is distinct 
from the physical file space which may contain user data and can be read 
or written. 


Passwords 


Passwords may be attached to any catalog or file. A password simply 
allows a user to traverse a catalog/file string. A user can get to a 
given catalog or file only if he can give the passwords for all higher 
level catalogs in the string. (When traversing a string, a password must 
not be given if none has been attached.) The originator of a given 
string is required to give the necessary passwords when traversing a 
string. 


Permissions 


User's permissions, both general and specific, can be attached to any 
catalog or file. When permissions are attached at the catalog level, 
they apply to all subordinate catalogs and files. The originator of a 
catalog/file string implicitly has all permissions for that string but 
must give all applicable passwords. 
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User's permissions are as follows: 


Read 
Write 
Append 
Execute 
Purge 


Modify 


allows a file to be read 

allows a file to be written 

(presently treated as WRITE) 

allows a file to be executed only (no list of file, etc.) 
allows catalogs and/or files to be purged from the system 
(specific permission only) 

allows catalog and/or file definitions to be changed 
(specific permission only) 
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Legend 


COC Denotes a file & & ( ) 
Denotes a Quick-Access file 


All user-ID's must-be unique within the system; all subcatalog and file 
names are automatically qualified by the user's master catalog name and 
the names of any intermediate subcatalogs. The system master catalog 
cannot be accessed by the normal user. 


"Identified by the user-ID. 


Figure 5-1. Logical Structure of the File System 


5-11 BSO1 


When operating under the Time-Sharing System, each file requested by an 
NEW or OLD command is a temporary working file, called the current file, 
that will disappear at the end of a user's session at the terminal 
unless he saves it. In the case of OLD, the current file is effectively 
a scratch copy of the named permanent file, allowing modifications to be 
made and tested without changing the original OLD file, unless the user 
explicitly resaves on that file. 


File content is written (i.e., stored) on a permanent file only by means 
of the SAVE or RESAVE commands. In addition, the SAVE command 
implicitly causes the file to be created. If the file named by the SAVE 
command does not already exist, the system automatically creates a 
permanent, external file and writes the contents of the current working 
file onto it. If the SAVE operand consists simply of a file name, the 
file created will be of the quick-access type. This type file emanates 
directly from a user's master catalog without intervening subcatalogs 
(see Figure 5-1). If a catalog-string precedes the file name in the SAVE 
operand, the subcatalog(s) named was previously created via the ACCESS 
subsystem, 


If the file to be written on already exists (whether created by a prior 
SAVE, by ACCESS, or by a batch activity), a RESAVE command causes’ the 
contents of the current file to be written to the named permanent file, 
replacing whatever contents existed in the named file. 


If the characteristics of the quick-access type of file are suitable to 
the user's requirements, the command language facilities offered by the 
system are sufficient; ACCESS need not be used. The OLD and GET 
commands, for example, offer full retrieval capabilites for files of any 
type or level. 


ACCESS SUBSYSTEM 


Capabilities 

For users who wish to utilize some or all of the capabilities of the 
file system, the ACCESS subsystem provides an interface. This interface 
allows the user to perform the following: 


e Create hierarchical structures of subcatalogs and files. 
e Attach passwords to his subcatalogs and files. 


e Give general permission to all other users to access his files 
in specified ways. 
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e Give specific permissions, by user-ID. 
e Protect a given file or set of files against any mode of access. 
e Gain the permitted types of access to another user's files. 


e Gain the permitted types of access to files created in the 
batch-processing environment. 


e Modify catalog name, password, and/or permissions on an existing 
catalog. 


e Modify file name, size, password, and/or permissions on an 
existing file. 


e Purge or release an existing file or catalog/file string. 
e List all catalogs and files which emanate from a given catalog. 
@e Rename files temporarily for a given job. 


e Create a random file with a logical-record-size attribute, if 
such a requirement exists. 


Use of ACCESS 


ACCESS consists of a number of functions which provide a conversational 
facility for the following: 


e Creating and purging/releasing catalogs and files. 


e Modifying catalog and file attributes (name, size, password, 
permissions). 


e Accessing and deaccessing files. 


e Listing catalogs and files. 


The operation of ACCESS consists of responses, via the terminal, to a 
sequence of English language questions. All of the standard vocabulary 
associated with the user's responses may be abbreviated for convenience 
in input. A nonconversational short form of input is also provided for 
more experienced users and users with batch FILSYS experience. 


ACCESS is not a means of reading or writing permanent file content. OLD 
and SAVE/RESAVE perform these functions. ACCESS is selected before 
proceeding to a desired processing subsystem; it is used for example to 
create a file (i.e., the file definition and the file space), before the 
substantive file is built under another subsystem. The OLD/NEW sequence 
and the SAVE/RESAVE commands of the succeeding subsystem(s) are still 
applicable. 
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Using the ACCESS subsystem, a file may be created at the system level by 
specifying the ACCESS subsystem name, the create command short form 
(CF), and the file description in one string in response to SYSTEM?. For 
example: 


SYSTEM?ACCESKCF , /CAT1SPASSWD1/CAT2$PASSWD2/FIL1LS$PASSWD3,B/1,3/,R,W,E 


The creation of the file is performed as in the conventional 
question-response sequence in the ACCESS subsystem. After this function 
is performed by access, the user is returned to the function selection 
level. 


NOTE: Similarly, any ACCESS function may be specified in a_=e single 
string response to SYSTEM?. 


Some general rules can be cited for the use of ACCESS. 


1. The ability of a user to access files and otherwise manipulate 
catalog/file structures (e.g. modifying and purging) depends 
upon his knowing the necessary file definitions. Beyond this, 
the file system has_ two file and catalog protection 
features--passwords and permissions. 


Permissions provide the file creator with a positive protection 
feature. If permissions are not explicity granted, his catalogs 
and files are completely protected by default. The user must 
assign to others any degree of access he wishes them to have. 
But, Since specific permissions for a given user do not add to, 
but replace, any general permission that may have been given, 
specific permissions may be used to exclude a given set of 
users from one or more types of access. 


Passwords provide an additional level of protection. a 6 
passwords are assigned by the creator of a catalog/file string, 
they must be supplied in order to pass through the string. 


The creator of a catalog/file string is exempt from any ACCESS 
mode restrictions he imposes (i.e., he implicitly has all 
permissions for his own catalogs and files), but he must give 
all passwords. 


The MODIFY permission, which allows another user to change file 
names, catalog names, file size, passwords, and/or permissions, 
also implies the ability of this other user to create catalogs 
and/or files emanating from the master catalog. 


2. The definition of a particular catalog or file must include the 
names of all higher level catalogs that must be traversed to 
arrive at that point. The catalog string would include at least 
the user's master catalog. A file definition, then, is the 
complete catalog string plus the file name. 


3. Each user's master catalog must be created for him before he 
can use the system. It has no password or permissions 
associated with it, and is unalterable. The installation 
usually controls the generation of this catalog. 
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4. If a delimiter immediately precedes the carriage return for an 
input line, a ? is issued to the user requesting continuation 
input. 


Identifiers and Delimiters in User Responses 


User responses are composed of the following: 


e Identifiers 
e Keywords 
e Word delimiters 


e Line delimiters 


Identifiers consist of file names, catalog names, user-IDs and 
passwords. They can be composed of alphabetics, numerics, periods, and 
minus Signs. Each identifier can be up to 12 characters in length except 
for file names, which are limited in length to eight characters, 


In response to the question FILE NAMESPASSWORD?, issued by the Access 
File function, a file name of up to 12 characters may be specified 
(l.e., the name of a batch-environment file), if followed by an 
alternate name of eight characters or less, enclosed in quotation marks. 
In response to FILE TO BE PURGED?, a file name of up to 12 characters 
could be specified, if the file to be purged were not created in the 
Time-Sharing System environment. 


Keywords consist of function names, access types (permissions), and 
several file type parameters, of limited interest. Keywords are used in 
responses to questions. All keywords, except EXCLUDE, DELETE and GEN'L, 
can always be abbreviated to the initial character, or a two-character 
acronym in the case of function name (e.g., R for READ permission or CC 
for Create Catalog function). 


The file size specification in the response to FILE NAME, SIZE  (BLKS), 
MAX SIZE? (Create File function), is a decimal number denoting the 
number of blocks required. This may be considered a special case of a 
keyword. 


Word delimiters are the slant or virgule (/), the dollar sign, and the 
comma. Blanks may be used freely in responses except within function 
names; they are in no sense delimiters and are ignored. 
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The use of the three word delimiters is as follows: 
The / delimiter has two functions: 


1. In catalog-strings, / indicates that a subcatalog name follows 
and is concatenated to the preceding catalog in the string. An 
initial / indicates that the following subcatalog-string (if 
any) is concatenated to the user's master catalog. A response 
to CATALOG STRUCTURE TO WORKING LEVEL? of / and carriage return 
is equivalent to the user's own user-ID; i.e., it positions the 
user to his own master catalog. 


2. In specific permissions, a / indicates that a user-ID follows. 


The $ delimiter is used only to concatenate a password to a catalog or 
file name. 


The , delimiter is used as a general separator for keywords; i.e., for 
separating access types and sizes, and separating file names from 
following keywords or sizes. 


The line delimiters are a carriage return, an asterisk plus’ carriage 
return, or a double asterisk plus a carriage return. Each of these 
Serves to terminate a response, but with a different effect. 


l. A carriage return following a response generally signifies that 
the user wishes to remain at the same catalog position (if 
relevant), and proceed to the next question in logical 
sequence. This may be the next question in a set, or _ the 
initial question again. 


When only a carriage return is given, (i.e., a null response) 
however, it has several possible meanings: 


@® In response to the question CATALOG STRUCTURE TO WORKING 
LEVEL? a carriage return only is equivalent to the user's 
own user-ID or a / and carriage return. Any of these 
responses requests that the user be positioned to his’ own 
master catalog. 


e A carriage-return only following a question that logically 
requires a response (e.g., NEW CATALOG?), causes an 
immediate return to the question FUNCTION?. 
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e The question SPECIFIC PERMISSIONS? recurs each time a 
response is given (delimited by a carriage return), since 
only one set of specific permissions can be given in each. 
If only a carriage return is given, the information received 
so far is processed, and the first question below CATALOG 
STRUCTURE TO WORKING LEVEL? is reissued (i.e., NEW CATALOG? 
or FILE NAME, SIZE (BLKS), MAX SIZE?), allowing a new 
catalog or file to be created at the same catalog level. 


e A carriage-return only response to FUNCTION? causes a return 
to the question SYSTEM?. 


2. If a single asterisk plus a carriage return is given in reply 
to a question, either with or without a substantive response, 
ACCESS processes the information it has and returns to the 
first question at the same catalog level (e.g., to skip any 
further questions in the set). ACCESS, of course, must have 
sufficient information to process. 


3. If a double asterisk plus a carriage return is given, either 
with or without a substantive response, ACCESS processes’ the 
information it has and returns to the question FUNCTION?. It 
implies that the user is finished with the current function. 
ACCESS, of course, must have sufficient information to process. 


In addition to the changes in level of operation produced by the several 
line delimiters, a response of DONE to any question causes an exit from 
ACCESS. No processing is performed and the question SYSTEM? results. 


ACCESS Functions 


The initial communication from ACCESS, following subsytem selection, is 
a request for a choice of function; i.e., FUNCTION?. 


The functions that may be requested and the effect produced by each 
function are as follows (function may be spelled out or abbreviated as 
indicated by the underlining): 
CREATE CATALOG - Creates a subcatalog. 
CREATE FILE - Defines file space and attributes for a given 
file name. It does not bring a file into the 
Available File Table (AFT). 
ACCESS FILE - Brings a file into the Available File Table. 
DEACCESS FILE ~ Takes a file out of the Available File Table. 


MODIFY CATALOG 


Modifies the name, password, and/or permissions 
associated with a given catalog. 


MODIFY FILE - Modifies the name, maximum size, password, and/or 
permissions associated with a given file. 
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PURGE CATALOG Deletes a catalog from the system along with any 
subcatalogs and files which are subordinate to 


it. All released file space is overwritten. 


PURGE FILE - Deletes a file from the system, overwriting the 
released file space. 


RELEASE CATALOG Deletes a catalog from the system, along with any 
subcatalogs and files which are subordinate to 


it. Any released file space is not overwritten. 


RELEASE FILE - Deletes a file from the system, but without 
overwriting the released file space. 


LIST CATALOG Lists the names of the catalogs and files which 


emanate from this catalog. 


LIST SPECIFIC Lists in detail the description of the catalog or 


file specified. 


Following the response to FUNCTION?, ACCESS asks the user to describe 
the catalog-string, catalog, or file. Each function has a fixed set of 
questions, with several of the questions common to each set. Some of the 
questions do not logically require a response; e.g., PASSWORD? (there 
may be none). If no response is applicable, only a carriage return is 
given. 


All the functions, except DEACCESS FILE, first request a definition of 
the existing catalog-string. Then the name of the catalog or file to be 
processed is next, along with size attributes in the case of a file. 
Passwords and permissions are then requested, as appropriate. 


SHORT=-FORM USAGE OF ACCESS FUNCTIONS 


Once the user has become familiar with the conversational, or 
question/response sequence, form of ACCESS, he may use a short form of 
function specification which effectively eliminates questions normally 


asked. In this short form, the function name (e.g., CREATE FILE) is 
followed directly by all the user-entered information needed to complete 
the function specification, usually all on one _ line. Each item of 


information is separated from other items by commas. 


The information entered in this short form is much the same as that 
given as responses in the conversational mode, but with additional 
keywords. The format is identical to that of the batch file system 
(FILSYS) input. 
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The general format, in response to the initial question FUNCTION?, is: 
function-name, catalog/file string, option, ..., option 


Where: catalog/file string is the same as in conversational 
responses, and options are: 


Form Function 
PASSWORD/password/ password assignment 
access-type general permissions 
access-type/ Specific permissions 


user-ID,...,user-ID/ 


BLOCKS 
1%1Y¥/ size assignment 

LINKS 
MODE/mode/ mode assignment 


Access type and mode are defined under each applicable function 
description. Options may appear, comma separated, in any order. The 
keywords BLOCKS and LINKS may be abbreviated to the first letter, as may 
the access type and mode words. Options unique to the Modify Catalog 
and Modify File functions are described along with those functions. 


The short form reply may be extended to two or more typing lines by 
terminating a line with a word delimiter (slant, comma, or dollar’ sign) 
(plus carriage return), at a convenient point, implying that the input 
is not complete but is to be carried over to the next line or lines. 


QUESTIONS AND RESPONSES 


Sets of questions associated with each function follow, along with the 
general form of the response to each question. The minimum required user 
response is underlined for illustrative purposes. Each set is followed 
by illustrative examples. 


1. FUNCTION? CC 
CATALOG STRUCTURE TO WORKING LEVEL? 
user-ID/cat-nameS$password/.../cat-name$password 
NEW CATALOG? cat-name 
PASSWORD? password 


GENERAL PERMISSIONS? access-type,...,access-type 
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The access types follow; all may be spelied out, or abbreviated as 
underlined; except for EXCLUDE, which must be spelled out: 

READ 

WRITE 

APPEND 

EXECUTE 

MODIFY (specific permission only) 

PURGE (specific permission only) 

EXCLUDE 

SPECIFIC PERMISSION? 

access type,...,access type/user-ID/.../user-ID 

If no response to the question SPECIFIC PERMISSION? is given, 


(i.e., only a carriage return), the catalog is created and the 
question NEW CATALOG? is reissued. 


Example replies (user responses are underlined): 


FUNCTION? CC 

CATALOG STRUCTURE TO WORKING LEVEL? 

JDOE/CATISABC 

This response states that there is a subcatalog named CAT1 that is 
concatenated directly to the user's master catalog identified by 
the user-ID JDOE, and that it is desired to create a new catalog 
from this level. The password ABC was attached to catalog CAT1 when 
it was created. 

NEW CATALOG? CAT2 

This response indicates the name of the catalog, CAT2, created at 
this point. 

PASSWORD? AOK 

This response associates the password AOK with this catalog. A 


carriage return alone would indicate that no password is to be 
assigned. 
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GENERAL PERMISSIONS? 


The lack of a response here indicates that general permission is 
not granted at this level for any type of access to subsummed 
files. A response of READ, EXECUTE would indicate that any 
unspecified user has permission to read and execute (if meaningful) 
any file that emanates from this catalog. 


SPECIFIC PERMISSION? READ/BJONES/ASMITH 


SPECIFIC PERMISSION? READ,WRITE,PURGE/ALLONG 


This combination of responses states that the users who have logged 
onto the system under the names BJONES and ASMITH can pass’~ through 
this level with Read permission for any files below, and that the 
user ALLONG can pass through with Read, Write, and Purge 
permissions. 


SPECIFIC PERMISSION? 

The carriage return alone means that no further specific 
permissions are to be given; the catalog is now created and the 
question 

NEW CATALOG? 

is reissued, allowing the user to create another catalog at the 


same level (i.e., also emanating from CAT1). 


Alternative forms of the response to CATALOG STRUCTURE TO WORKING 
LEVEL? are as follows: 

/CATI1SABC 

Assuming the user to be JDOE, this response is equivalent to the 


one given above, JDOE/CATISABC. The initial slant indicates the 
user's own master catalog. 


A response of / indicates that the user desires to create directly 
from his master catalog. This response is equivalent to his user-ID 
alone. 


Example of short form reply: 


FUNCTION? CC,/CATISABC/CAT2,PASSWORD/AOK/, READ/BJONES, 
? ASMITH,ALLONG/, WRITE/ALLONG/ , PURGE/ALLONG/ 
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FUNCTION? CF 


CATALOG STRUCTURE TO WORKING LEVEL? 


user-ID/cat-nameSpassword/.../cat-name$password 
FILE NAME, SIZE (IN BLCKS), MAX SIZE? 


file name, initial size (blocks), maximum size (blocks) 
PASSWORD? password 


GENERAL PERMISSIONS? access type,...,access type 


The access types follow; they may be spelled out, or abbreviated as 


underlined: 


READ 

WRITE 

APPEND 

EXECUTE 

MODIFY (specific permission only) 


PURGE (specific permission only) 
SPECIFIC PERMISSION? 
access type,...,access type/user-ID.../user-ID 


Random File Specification: If required, a file can be created 
a random-access-treatment indication, by responding to the 
NAME, SIZE (IN BLCKS), MAX SIZE? question as follows: 


file name, initial size, max. size, R 
If random (R) is specified, a further question will be asked: 


LOGICAL RECORD SIZE? record size in words 


with 
FILE 
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Random-I/O files for Time-Sharing FORTRAN are required to have a 
logical record size attribute; if use of random files does not 
require this attribute, a response with a carriage return only is 
required. 


If the file is created as random, it cannot be accessed as_ linked 
(i.e., sequential), but the converse is true. Refer to Access File 
function description. Further details for random specifications are 
given in the Special Features paragraph. 


Example replies (user responses are underlined): 
FUNCTION? CF 
CATALOG STRUCTURE TO WORKING LEVEL? 


/CATISABC/CAT2SAOK 
This response defines user-ID/CATI1/CAT2 as the catalog-string from 


which the file is to emanate. The initial slant indicates that the 
succeeding string is concatenated to the user's own master catalog. 


FILE NAME, SIZE (IN BLCKS), MAX SIZE? FIL1,4,12 


This response asks for a file space of four blocks initially, with 
a maximum eventual size limit of 12 blocks, named FILI1. 


PASSWORD? 


No password is assigned to this individual file. 
GENERAL PERMISSIONS? READ 
SPECIFIC PERMISSION? 


None are granted at this level, but those granted at the level of 
CAT2 (CREATE CATALOG in the previous example) apply to this file. 


The lack of a response means the end of the information relevant to 
the creation of this file. The file is created, and the question 


FILE NAME, SIZE (IN BLCKS), MAX SIZE? 


is reissued. This permits creation of other files at the same 
level. 
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Example of short form reply: 
FUNCTION? CF,/CATISABC/CAT2SAOK/FIL1,B/4,12/,R 


Note: File mode by default is linked (sequential); I 26% ¥ 
MODE/LINKED/. 


FUNCTION? AF 


CATALOG STRUCTURE TO WORKING LEVEL? 


user-ID/cat-nameS$password/.../cat-nameSpassword 


FILE NAMESPASSWORD? file name(alternate name) $password 


PERMISSIONS DESIRED? 


access type,-...,access type 


The access types follow: they may be spelled out, or abbreviated as 
underlined: 


READ 

WRITE 

APPEND 

EXECUTE 
Random File Specification: A file can be accessed for random 
treatment, whether created as random or linked, by responding to 
the FILE NAMESPASSWORD? question with: 

filename, R$password 


or 


filename(alternate name) ,R$password 


If the file was created as linked, the random treatment indication 
is temporary; i.e., for the current access only. If the file was 
created as random, the ,R specification is superfluous. 
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Example replies (user responses are underlined): 
FUNCTION? AF 
CATALOG STRUCTURE TO WORKING LEVEL? 


JDOE/CATISABC/CAT2SAOK 

The user in this case is not the creator of the file to be 
accessed, so he must define the user's master catalog (e.g., JDOE) 
from which the file emanates, along with any required subcatalogs 
and passwords. 


FILE NAMESPASSWORD? FIL1 


If a password were required, it would be concatenated to the name 
With a dollar sign; i.e., FILI1SABC. 


PERMISSIONS DESIRED? READ 


General Read permission was granted for this file. (Several 
Specific Read permissions were also granted at the level 
immediately above CAT2.) Termination of this response with only a 
carriage return causes the file to be accessed and the request 


FILENAMES PASSWORD? 


to be reissued. 
Example of short form reply: 


FUNCTION? AF,JDOE/CATISABC/CAT2SAOK/FIL1,R 


FUNCTION? DF 


FILE NAME? file name (or CLEARFILES) 

The response for this function is the name of the file to be 
deaccessed. The name supplied is always the name under which the 
file was accessed, whether this was the actual name or a temporary 


alternate name. If CLEARFILES is used, all of the user's available 
files are deaccessed, including his temporary files. 


Example of short form reply: 


FUNCTION? DF,FIL1 
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FUNCTION? PC 

CATALOG STRUCTURE TO WORKING LEVEL? 
user-ID/cat-name$password/.../cat-name$password 
CAT. TO BE PURGED? cat-name 

PASSWORD? password 

Example replies (user responses are underlined): 
FUNCTION? PC 

CATALOG STRUCTURE TO WORKING LEVEL? 

/CAT1SABC 

This response defines the subcatalog CAT1 concatenated to 
user's own master catalog. 

CAT. TO BE PURGED? CAT2 


PASSWORD? AOK 


The dollar sign is used only when the password is _ concate 
directly to a file or catalog name. The request 


CAT. TO BE PURGED? 


is reissued. 
Example of short form reply: 


FUNCTION? PC,/CATISABC/CAT2SAOK 


the 


nated 
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FUNCTION? PE 

CATALOG STRUCTURE TO WORKING LEVEL? 
user-ID/cat-nameS$password/.../cat-name$password 
FILE TO BE PURGED? file name 

PASSWORD? password 

Example replies (user responses are underlined): 
FUNCTION? PF 

CATALOG STRUCTURE TO WORKING LEVEL? 


JDOE/CAT1SABC/CAT2SAOK 


The user in this case is ALLONG, not the file creator. 


PASSWORD? 
The user (ALLONG) was given specific purge permission at the 
of CAT2. 


The request 


FILE TO BE PURGED? 


is reissued. 
Example of short form reply: 


FUNCTION? PF,JDOE/CATISABC/CAT2SAOK/FIL1 


level 
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FUNCTION? RC 


The question/response sequence and the short form reply for this 
function are completely analogous to those for the Purge Catalog 
function. The Release Catalog function would normally be used in 
preference to Purge Catalog -- as it is more economical -- unless 
the user has a very stringent file-security requirement. 


FUNCTION? RF 


The question/response sequence and the short form reply for this 
function are completely analogous to those for the Purge File 
function. The Release File function would normally be used in 
preference to Purge File -- as it is more economical -- unless’ the 
user has a very stringent file-security requirement. 


FUNCTION? MC 
CATALOG STRUCTURE INCLUDING CATALOG TO BE MODIFIED? 
user-ID/cat-nameSpassword,...,cat-nameS$password 


NEW NAME? new cat-name 


new password 
PASSWORD? 


DELETE 


access type,...,access type 
GENERAL PERMISSIONS? 
DELETE 


user-ID.../user-ID 
\ DELETE/user-ID/.../user-ID 


access type,...,access  } 
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Example replies (user responses are underlined): 


FUNCTION? MC 
CATALOG STRUCTURE INCLUDING CATALOG TO BE MODIFIED? 
/CAT1$ABC/CAT2$A0K 


NEW NAME? 

A carriage return only response means that the catalog name is to 
remain unchanged. 

PASSWORD? XYZ 


The original password AOK is replaced by XYZ. 


GENERAL PERMISSIONS? READ 

As originally created, general permissions were not assigned at 
this level. This response replaces this null set with READ 
permission. 

SPECIFIC PERMISSION? R,W/BJONES 

This response replaces the original specific READ permission for 


BJONES with READ and WRITE permission. 


SPECIFIC PERMISSION? DELETE/ASMITH 


TY 


This response cancels any permissions for ASMITH that previously 
existed. 


SPECIFIC PERMISSION? R,W,P,M/ALLONG 


This response replaces the original set of READ, WRITE and PURGE 
permissions for ALLONG with READ, WRITE, PURGE, and MODIFY. 
SPECIFIC PERMISSION? 

The carriage return implies that no further modifications are to be 
made; the changes are now processed and the question 


CATALOG STRUCTURE INCLUDING CATALOG TO BE MODIFIED? 


is reissued. 


5-29 BSO1 


10. 


Special Short Form Option Formats 


To rename a catalog: 


NEWNAME/catalog/ 


To exclude, by user-ID, from any general permissions: 


To delete specific permissions, by user-ID: 


DELETE/user-ID,...,user-ID/ 


To delete al] general permissions: 


DELETE/GEN'L (or simply DELETE) 
Note: EXCLUDE and DELETE may not be abbreviated. 
Example of short form reply: 


FUNCTION? MC,/CAT1SABC/CAT2SAOK , PASSWORD/ 
?XYZ/,R,R/BJONES , ALLONG/,W/BJONES , ALLONG/, 
?P /ALLONG/ ,M/ALLONG/ , DELETE/ASMITH/ , EXCLUDE/ 


?ASMITH/ 
FUNCTION? MF 


CATALOG STRUCTURE INCLUDING FILE TO BE MODIFIED? 


user-ID/cat-nameSpassword/.../ cat-nameSpassword/file name$password 
NEW NAME? new file name 


NEW MAX SIZE? new maximum size (in blocks) 


PASSWORD? 
DELETE 


new password : 
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access type,...,access type 
GENERAL PERMISSIONS? 
DELETE 


‘access type/user-ID/.../user-ID 
SPECIFIC PERMISSION? ( 


DELETE/user-ID/.../user-ID 

Example replies (user responses are underlined) : 

FUNCTION? MF 

CATALOG STRUCTURE INCLUDING FILE TO BE MODIFIED? 
/CATISABC/CAT2SXYZ/FIL1 

NEW NAME? MASTERL 

NEW MAX SIZE? 20 

This response increases the maximum file size to 20 blocks 
(originally 12). 

PASSWORD? DEPT37 

This response attaches the password DEPT37 to this file (none 


originally assigned). 


GENERAL PERMISSION? DELETE 

The original general READ permission is deleted. 

SPECIFIC PERMISSION? P/BJONES 

PURGE permission for user BJONES is added at this level. This 


permission applies to this file only, but he also has READ and 
WRITE from the CAT2 level. 


Special of short form option formats: 


To rename a file: 


NEWNAME/file name 
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To exclude, by user-ID, from any general permissions: 


EXCLUDE/user-ID,...,user-ID/ 


To delete, by user-ID, specific permissions: 


DELETE/user-ID,...,user-ID/ 


To delete all general permissions: 
DELETE/GEN'L/ 
or 


DELETE 
Note: EXCLUDE and DELETE may not be abbreviated. 
Example of short form reply: 
FUNCTION? MF ,/CATISABC/CAT2SXYZ/FIL1 ,N/ 
? MASTER1/,B/20/,P/DEPT37/,DELETE ,P/BJONES/ 
FUNCTION? LC 
CATALOG STRUCTURE INCLUDING CATALOG TO BE LISTED? 
user-ID/cat-name,...,cat-name 
Example replies (user responses are underlined): 
FUNCTION? LC 


CATALOG STRUCTURE INCLUDING CATALOG TO BE LISTED? 


JCAT I 


Passwords need not be given in the catalog structure. A user is 
permitted to list only his own catalogs or the Library catalog 
(#LIB). 


A list of the catalogs and files emanating from CAT1 would now be 
output. 
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12. FUNCTION? LS 
CATALOG STRUCTURE INCLUDING CATALOG OR FILE TO BE LISTED? 
user-ID/cat-name,...,cat-name(or)file name 
Example replies (user responses are underlined): 


FUNCTION? LS 
CATALOG STRUCTURE INCLUDING CATALOG OR FILE TO BE LISTED? 
/CATL 


Passwords need not be given in the catalog structure and will not 
be included in the catalog or file description which is output. A 
user can list only his own or library (#LIB) catalogs or files. 


The description of CAT1 would now be output. 


The system will provide the following information (but not the 
password) about the catalog or file: 


FILE NAME- 
ORIGINATOR= 
DATE CREATED- 
DATE CHANGED-MONTH/DAY/YEAR (T.O.D.) (Contents of File) 
LAST DATE ACCESSED- 
MAX FILE SIZE- 
CURRENT FILE SIZE- 
FILE TYPE-RANDOM (xxxxxx) 
where: Xxxxxx is file type if ASCII (created by TSS) 
or I-D-S 
DEVICE- 
GENERAL PERMISSIONS- 
SPECIFIC PERMISSIONS- 
FILE IN ABORT STATUS (if file is in abort status) 


EXAMPLES OF LINE DELIMITER USE 


The line delimiters can be used in several ways to either shorten the 
question/response sequence, or terminate a function at any given point. 


Examples of the effect of different response terminations are as 
follows: 


FUNCTION? CC 


The carriage return alone implies a master catalog. 
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NEW CATALOG? 001* 
Passwords or permissions are not wanted for this catalog and no further 
questions are wanted. Return is to NEW CATALOG? level. 


NEW CATALOG? 002 


PASSWORD? PASS2** 


No permissions are to be assigned to this catalog, and creation of 
catalogs at this position is finished. Return is to function level. 
FUNCTION? CF 

CATALOG STRUCTURE TO WORKING LEVEL? 

/002$SPASS2 

FILE NAME, SIZE (IN BLCKS), MAX SIZE? 02.1,1,3 


GENERAL PERMISSIONS? READ 


SPECIFIC PERMISSION? W/RJJONES** 


Creation of files at this level has been completed. 


FUNCTIONS? carriage return (or DONE) 


Finished with ACCESS. 


SYSTEM? 


Return to the subsystem selection level. 
SPECIAL FEATURES 


Files created by means of the Create File function are not necessarily 
contiguous; i.e., successive links of a multilink file are not 
necessarily in physical sequence on the storage device. Furthermore, 
both the Create File and Access File functions assume that the file will 
be treated as a linked file. For the standard subsystems provided with 
the Time-Sharing System, these file characteristics are suitable because 
linked files are required. 
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If, however, in the use of a given subsystem, it would be advantageous 
to have contiguous files, this characteristic can be specified in 
response to FILE NAME, SIZE (IN BLCKS), MAX SIZE?. The form of this 
response is: 


file name, initial size C 


The parameter C indicates, in Create File only, that a contiguous file 
is desired. No maximum size may be specified. 


Similarly, if random treatment of files is required in a _ given 
user-written subsystem, a file can either be created as a random file or 
accessed as a random file. If created as such, it is always treated by 
the GCOS I/O Supervisor as a random file. If it is created as a linked 
file, it can be accessed as a random file, but in that case, the random 
treatment indication is temporary; i.e., it applies to that access only. 


The forms of the random specification are as follows: 
For Create File, the response to FILE NAME, SIZE (IN BLCKS), MAX SIZE? 
is: 
file name,initial size,maximum size,R 
or 


file name,initial size C,R 
For Access File, the response to FILE NAMESPASSWORD? is: 


file name, RSpassword 


In both responses, the parameter R (always preceded by a _ comma) 
indicates that the named file is to be treated as a random file. 


In the case of Create File only, the additional question LOGICAL RECORD 
SIZE? is asked, allowing the user to specify a fixed logical record size 
attribute as required of random files by TSS FORTRAN. If this attribute 
is not needed, the user may respond with simply a carriage return. 


In the short form response, random files can be specified by: 


MODE/RAND/ or MODE/R/ 
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Linked files can be specified explicitly, either by: 


MODE/LINKED/ or MODE/L/ 
or 


MODE/SEQ/ or MODE/S/ 


or, more simply, by default. 


Contiguity cannot be specified in the short form response. 


REQUEST DENIED MESSAGES 


The following messages are printed following a complete function 
request, and indicate that the request could not be satisfied. The 
reason for denial is given in each case. 


REQUEST DENIED-NEW NAME SAME AS AN EXISTING NAME 


A new catalog or file name has been given that is the same as an 
existing catalog or file name at the same level. 


REQUEST DENIED-FILE SPACE REQUESTED EXCEEDS ALLOWED 


The user has requested file space exceeding the amount that has 
been allotted to him in his System Master Catalog entry. 


REQUEST DENIED-NEW SIZE LESS THAN CURRENT SIZE 


In MODIFY FILE, a new file size has been specified which is less 
than that currently used by the file. 


REQUEST DENIED-SYSTEM MALFUNCTION 


An unrecoverable I/O error has occurred. 


REQUEST DENIED-PERMISSION NOT GRANTED 


The user does not possess the requested permission(s). 
REQUEST DENIED-FILE BUSY 


The requested file is currently busy to the type of permission(s) 
requested. 
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REQUEST DENIED-INCORRECT CAT/FILE DESCRIPTION 

This denial is given whenever required passwords are not included 
or the catalog/file description is not logically correct. 

REQUEST DENIED-SYSTEM LOADED 

The requested file function cannot be completed because there is 
temporarily no file space available. 

REQUEST DENIED-YOUR AVAILABLE FILE TABLE IS FULL 

The user has too many files accessed (open) at the same time. This 
situation can be eliminated by deaccessing some of the accessed 
files. 

REQUEST DENIED-FILE NAME A DUPLICATE, MUST GIVE ALTERNATE NAME 

An ACCESS FILE has been done where the file name is a duplicate of 
a file which the user currently has open. The alternate name 
capability can be used to avoid this situation. 

REQUEST DENIED-YOU CAN LIST ONLY "YOUR" OWN CATALOGS OR FILES 


The user ios Eequcetee a listing of catalogs and/or 


descriptions (List Catalog or List Specetic) for catalogs and, 


files that do not emanate from his own user's-master-catalog. 


REQUEST DENIED-UNDEFINED STATUS 
A system malfunction (other than an internal I/O error) occurred 


during the attempt to satisfy the requested function. Contact the 
resident system-maintenance authority or the central computer site. 


INPUT ERROR MESSAGES 


The following messages are printed immediately following the input in 
error and the original question is repeated. 

ERR-ILLEGAL CHARACTER 

A character other than an alphabetic, numeric, period, or dash has 


been included in an identifier. An upward arrow (t) points at the 
character in error. 


ERR-INVALID DELIMITER 


An otherwise valid delimiter has been given out ot place. An upward 
arrow (t) points at the delimiter in error. 
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ERR-XXXXXXXXXXXX-MUST BE LESS THAN 13 CHARACTERS 


The designated identifier is limited to 12 characters. 


ERR-XXXX-IS NOT A LEGITIMATE PERMISSION 

Legitimate permissions are READ, WRITE, APPEND, and EXECUTE, plus 
PURGE and MODIFY as specific permissions only. 
ERR-XXXXXXXXXXXX-MUST BE LESS THAN 9 CHARACTERS 


The designated identifier is limited to eight characters. 


ERR-XXXX-MUST BE AN INTEGER 


A non-numeric character has been included in field XXXX. 


ERR-XXXXX-MUST BE LESS THAN 10000 


The field is limited to four digits. 


ERR-INPUT REQUIRED 


A null response was given to a question which requires input. 


ERR-INITIAL SIZE GREATER THAN MAX SIZE 


In defining the file size, an initial size greater than the maximum 
size was given. 


RECOVERY SUBSYSTEM 


The RECOVERY subsystem gives the terminal user the ability to make his 
collector file permanent and to catalog it under his User Master Catalog 
(UMC). Thus a user has the ability to recover his last input lines in 
any Situation where an accidental or unexpected disconnect occurs. 


The collector file will contain the lines of data entered via the 
terminal which have not yet been edited into the current file (see 
Definition, Section I, for definition of current file). The number of 
lines in the collector file may vary because of line length and _ the 
amount of data entered since the last edit of the collector file to the 
current file. In general, it will contain up to the last 70 lines. The 
RECOVERY subsystem, when used with the OLDP and NEWP functions provides 
the terminal user with the ability to recover the entire file when a 
disconnect occurs. 
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The RECOVERY subsystem is initiated through the common command langauge 
of the following systems: 


BASIC 
Time-Sharing FORTRAN 
Text EDITOR 


CARDIN 


The terminal user can request the RECOVER command at any level; that is, 
at the subsystem selection level or at the command level. 


The RECOVERY subsystem also permits the use of the ROLLBACK command to 
recover the collector file at the user's next terminal session. The 
ROLLBACK command can be issued only at the command level. 


Recovery Operation 


In its basic operation, the RECOVERY subsystem dumps data currently on 
the temporary input collector file to the current file and creates 
and/or accesses a permanent file specified in the command (by filename) 
with an alternate name. If this permanent file aiready exists in the 
user's System Master Catalog, the file is checked to assure that it 
conforms to the minimum requirements for an input collector file. The 
major requirements for an input collector file are that the file must be 
a random file and it must be at least 640 words (two blocks) long. A 
longer file will be accepted, but only 640 words will be used. 


If the filename is not in the user's UMC, a file will be created and 
given predefined attributes. It will then be accessed by an alternate 
name. Accessing the file by the alternate name puts the alternate name 
in the Available File Table (AFT). The RECOVERY subsystem then switches 
the two file names; one representing the temporary input collector file 
and the other representing the permanent recovery file. Thus, all 
reference to the input collector file now points to the PAT describing 
the permanent recovery file. Even if this is not a random file, it will 
be accessed as a random file. 


The procedure for termination, user log-off, or disconnect is the 
reverse of the procedure described above. The Available File Table (AFT) 
will contain at least two PAT's (assuming that recovery was requested). 
The names associated with these PAT's will be switched and the files 
will be deallocated by the TERM module of the Time-Sharing System. 
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When the terminal user issues the ROLLBACK command, the RECOVERY 
subsystem will again copy any data currently on the temporary input 
collector file to the current working file. It will then access the file 
specified in the command. When accessed, the permanent recovery file is 
read and any data in this file is also copied on the current working 
file. The last line of good data on this file, preceded by an 
identifying message, is printed out on the terminal. Thus, when the user 
receives a SUCCESSFUL message following a ROLLBACK command, he is’ ready 
to type into an empty 640-word collector file. 


A terminal user may issue any number of RECOVERY and/or ROLLBACK 
commands during his session at the terminal. When subsequent commands 
are issued, the previous RECOVERY file is deaccessed, and a new RECOVERY 
file is created and/or accessed. The perm file remains in the user's 
catalog until he specifically releases it. 


If an error occurs during the creation and/or accessing of the new 
RECOVERY file, the terminal user will be working with a temporary input 
collector file and not his RECOVERY file. The data on the RECOVERY file 
may be unrecoverable (because of a missing end-of-file) if the terminal 
user tries to access this file through any other subsystem. 


QUESTIONS AND RESPONSES 


The following paragraphs describe sets of questions and general 
responses associated with the RECOVER and ROLLBACK commands. In these 
descriptions, the general response to each question is underlined to set 
it: apart. 


SYSTEM ?RECO FILISABC 
SUCCESSFUL 


The RECOVERY subsystem is called to create and/or access FIL1. Control 
is then returned to the subsystem selection level SYSTEM?. #RECO cannot 
be given at this level. 


SYSTEM ?BASIC 

OLD OR NEW - OLD FIL2 
READY 

* RECO Fis 
SUCCESSFUL 


The user has specified that FIL2 be written on his current working file. 
RECOVERY subsystem is then called to create and/or access FIL3. Control 
is returned to the previous calling level. 
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SYSTEM ?EDIT 
OLD OR NEW-NEW 
READY aie 
*#REC FIL4 
SUCCESSFUL 


The user requests the EDIT subsystem and a current working file. At the 
command level, the user calls for RECOVERY to create and/or access FIL4. 
Control is returned to the previous calling level. 


SYSTEM ?BASIC 
OLD OR NEW-NEW 
READY 

*10 PRINT 

*20 PRINT 
*RECO FIL5$BCA 
SUCCESSFUL 


The BASIC Editor is called to sort and merge lines 10 and 20 onto the 
current working file. RECOVERY subsystem is then called to create and/or 
access FIL5. Control is returned to the previous calling level. 


SYSTEM ?BASIC 
OLD OR NEW-NEW 
READY 

*RECO FIL6$CAB 
*I0 PRINT 

*20 PRINT 

*30 PRINT 


Assume that at this point the computer system disconnects. The user will 
do the following to recover his last input lines. 


SYSTEM ?BASIC 

OLD OR NEW-NEW 

READY ~— 

*ROLL FIL6S$CAB 

LAST LINE of SAVED DATA IS: 
30 PRINT 

SUCCESSFUL 


Prior to the disconnect, this operation was normal. When the system is 
restarted after the disconnect, the user calls in the RECOVERY subsystem 
by issuing the ROLLBACK command. The RECOVERY subsystem will access 
FIL6 and sort and merge the data onto the current working file. When the 
SUCCESSFUL message is issued, the user is ready to type into an empty 
640-word collector file. Return is to the previous calling level. 
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ERROR MESSAGES 


The following error messages are printed on the terminal following a 
complete request. 


FILE IS NOT 2-BLOCKS LONG 

The requested file size is less than the minimum size required. 
(Create by other subsystems.) 

THIS FILE IS NOT A RANDOM FILE 

The requested file is not a random file. (Created by other 
subsystem.) 

THIS FILE IS NOT A PERM FILE 


The requested file is not a permanent file in the user's SMC. Files 
cannot be subcataloged. 


FILE filename, STATUS XX 


When the requested file was created and/or accessed, an illegal 
status occurred. 


RECOVERY FILE--1I/0 STATUS XX 


The RECOVERY file is read and there is a bad return status. 


IMPOSSIBLE TO RECOVER DATA FROM RECOVERY FILE 


Two 640-word blocks were read in and the last good line of data 
could not be determined. 


ERROR MESSAGES WITH RESPONSE 


INVALID INPUT RETYPE 
This error message indicates that the filename and/or the password 
is too long or the filename contains an illegal character. The 
response may be: 

Filename$password (the corrected format) 


or 


Carriage Return (Return to previous calling level) 
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After two unsuccessful attempts the following message is given and 
return is made to the previous calling level: 


INVALID INPUT 


TIME-SHARING MEDIA CONVERSION PROGRAM 


The Time-Sharing Media Conversion Program is a batch program that may be 
run either at the central computer site or through a remote/batch (GRTS) 
terminal. It generates a standard format, time-sharing text file froma 
suitable card deck, or conversely, produces a card deck from such a 
file, however generated, to save the file in card form. 


Operational Description 


The media conversion program performs the following functions: 


INPUT - create a standard format, time-sharing text file from 
cards. If the INSERT or MOVE option is used, # signs are 
inserted between the line number and the first character of 
numeric data. 


OUTPUT - create a card deck from a standard format, time-sharing 
text file. # Signs between the line number and the text are 
deleted. 


The control record (card) will be printed on the execution report. 


INPUT identifies the control card requesting the file creating function 
and takes the following mutually excluSive options: 


Option 


ASIS,i,j 


MOVE ,i,j 


Result 


The text file is generated from the input cards, from 
the columns specified by i to j. Standard columns 
(detault option). for 2. tO. 5 are.) to 80. 


py The text file is generated from the input cards, from 
the columns specified by i to Jj. Line numbers are 
taken from columns specified by m to n. Standard 
columns for 2 to j are 1 to 72, and for m to. n are 73 
to. 80; 
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an 


INSERT,i,j,m,n 


ASCII 


COMDK ,option 


The text file is generated from the input cards and 
from the columns specified by i to gj. Lines are 
sequence numbered, starting with m and incremented by 
n. Standard columns for i to j are 1 to 72. Standard 
values for both m and n are 10. 


The text file is generated from input cards, using a 
binary deck previously punched from this program, 


The text file is generated from input cards consisting 
of a COMDK (compressed source deck). This option is 
used in conjunction with the ASIS, MOVE, or INSERT 
options. If ALTER's are to be made at the time the 
file is generated, a $ DATA I*,,COPY and a $ ENDCOPY 
card must be employed. 


Sample INPUT Control Cards 


INPUT ,MOVE,1,60,73,80 


Text file data is to be taken from columns 1 to 60 of the punched 
cards and line numbers are to be taken from columns 73 to 80. 


INPUT ,COMDK ,ASIS,1,80 


Text file data is to be taken from columns 1 to 80 of the input 
cards (a COMDK). 


INPUT can start in any column of the control card but no imbedded 
blanks are allowed. 


OUTPUT identifies the control card requesting the card-deck producing 
function, and takes the following mutually exclusive options: 


Option 


ASIS,i,j 


Result 


The text file is read and a BCD card deck is’' punched 
in the columns specified by i to j. Standard columns 
(default option) for i to j are 1 to 80. 
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MOVE,i,j,m,n,1l The text file is read and a BCD card deck is punched, 
moving data to columns specified by i to j. Line 
numbers are moved to columns specified by m to nn, 
right-justified. The 1 specifies the label to be 
punched starting in column Ty left-justified. 
Standard columns for i to j are 1 to 72 and for m_ to 
n, 73 to 80. 


STRIP,i,3 The text file is read and a card deck is_ punched, 
stripping off line numbers, with data moved to _ the 
columns specified by i to j. Standard columns for i to 
j are 1 to 80. 


Note 


With the above output options, data is converted from 
ASCII to BCD before punching. 


ASCII The text file is read and a binary deck containing the 
file text is punched. (See "Binary Card Format" 
below.) 


Sample OUTPUT Control Card 
OUTPUT,ASIS,1,56 
The text file is punched into columns 1 to 56 of the card deck. 


OUTPUT can start in any column of the control card but no imbedded 
blanks are allowed. 


Definitions 


@e Each line is punched on a separate card, starting in the column 
specified (OUTPUT function). 


e A line number is an initial string of numeric characters which 
terminate with a nonnumeric character. Blank is considered a 
nonnumeric character. 


e In the case of the MOVE option, the line numbers are _ stored 
right-justified in the columns specified. 
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e The 


format-of a line ina text file is as follows: 


(nnn) dddd....d (carriage return character) 


Where: nnn - Line number (numeric; must terminate 


Errors 


SE ABORT 


CK ABORT - 


NB ABORT - 


CP ABORT - 


with non-numeric character). 
dd..d - Data. 
Carriage return terminates the data line. 


A binary card is out of sequence. 
Card number is printed out. 


Checksum of card does not agree with the computed checksum. 


First-data card is not binary, but ASCII was specified on 
control card. 


No control card found (keyword may be misspelled). 


DATA LINE TOO LONG FOR I,J FIELD 


».».portion of the line specified by i to j... 


Occurs on OUTPUT only. If a line of the file is too long for 
the specified i to j field (i.e., mnonblank characters are 
being discarded), this warning message is issued along with 
the portion of the line specified by i, j. A maximum of 20 
such messages may be given. The complete file is punched, as 
specified by the i to j field options. 


Binary Card Format 


Word 1 


Word 2 


Word 3 


7/9 punch and number of data words 
(maximum=21) 


Checksum 


Card number, starting at 0 


Words 4-24 Text 
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Sample Deck Setups 


A sample deck setup to accomplish media conversion is as follows: 


$ SNUMB XXXXX 

$ IDENT account number,name 

$ USERID name$password 

S$ PROGRAM TSCONV 

S PRMFL OT,R/W,L,userid/filename 
INPUT ,ASIS 


(Data deck) 


S$ ENDJOB 
*kKXEOF 


A sample deck setup to accomplish media conversion in the case of 
COMDK plus ALTER cards is as follows. 


S$ SNUMB XXXXX 

$ IDENT account number 

$ USERID nameSpassword 

S$ PROGRAM TSCONV 

S$ PRMFL OT,R/W,L, userid/filename 
$ DATA I*,,COPY 

INPUT ,COMDK,ASIS,1,80 


(Data cards -- COMDK) 
S$ ENDCOPY 
S$ UPDATE 


(ALTER deck) 


$ ENDJOB 
** *EOF 


The following is a sample deck setup for an OUTPUT run. 


S$ SNUMB XXXXX 

$ IDENT account number,name 

$ USERID name$password 

S$ PROGRAM TSCONV 

$ PRMFL OT,R/W,L,userid/filename 
OUTPUT,ASIS 

S$ ENDJOB 

k*X*XEOF 


NOTE: As indicated in these deck setups, OT is the only file code used. 
IN is not used for the input file. 
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FORTRAN TRANSLATOR SUBSYSTEM 


The FORTRAN Translator (TRAN) is a time-sharing subsystem that allows 
the user to translate a Time-Sharing FORTRAN source program into a batch 
FORTRAN source program, with little or no hand recoding. TRAN will also 
produce input acceptable to Series 6000 FORTRAN. The translator 
substitutes, wherever possible, one or more batch-acceptable statements 
for each noncompatible Time-Sharing FORTRAN statement. 


Translation occurs in the input/output and data-specification statement 
categories. Several statement forms, primarily in the I/O area, are not 
automatically translatable. In these cases, the translator issues a 
message noting the untranslatable statement and pauses to allow the 
terminal user to enter a replacement statement. Thus, all noncompatible 
statements are detected by the subsystem and a large majority are 
automatically translated. 


The user has the option of saving the translation either in BCD (batch 
S*) form, in ASCII (time-sharing) form, or in both. A BCD file of the 
final translated program is provided for batch processing and is 
available to the batch dimension via the file system. Batch compiler 
input can be called directly from the BCD permanent file with a $ SELECT 
or a $ PRMFL S* card in the batch job control deck. For example, if the 
control deck was submitted by means of the CARDIN subsystem, it would 
appear as follows: 


0010$:IDENT:JDOE 
0020$:USERID: JDOESPASSWORD 
0030$:FORTRAN 
0040$:SELECT:JDOE/BCD 
0050$:ENDJOB 


In this input, BCD is the name of a BCD translation file from _ the 
FORTRAN Translator. 


The ASCII form is useful for obtaining a listing at the terminal; the 
listing may then be further updated or modified and passed directly to 
the GCOS System Input Program via CARDIN: 


**0001$:IDENT:JDOE 
**0002$: FORTRAN 
0008 (Comment inserted by Translator) 
0009 LOGICAL KKO00O1 (Inserted by Translator) 


: ASCII translation data 


0990 
**1000$ : ENDJOB 
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Lines marked ** are inserted by the user in CARDIN BUILD mode and lines 
0008 through 0990 represent an ASCII translation file from the FORTRAN 
Translator, named (in this example, ASCII). 


For both examples above, the CARDIN sequence is as follows (user 
responses underlined): 


SYSTEM ?CARDIN 

OLD OR NEW-NEW (for BCD example) 
(or) OLD ASCII (for ASCII example) 

READY 

* 


é (enter control cards as per examples above) 


*RUN 
CARD FORMAT AND DISPOSITION? NORM 


The NORM response implies MOVE and standard tab character and settings: 


$7 3,716,32,73 


General Usage 


The translator takes its program input from the user's current file (as- 
do most other time-sharing subsystems). 


The user selects the FORTRAN Translator with the name TRAN (only the 
first four characters of the name are needed) at the subsystem selection 
level (SYSTEM?). He then normally responds OLD filename to the OLD OR 
NEW - question, naming the time-sharing (ASCII) file that contains the 
program to be translated. If, however, the current file already contains 
the desired program, he may simply respond SAME to the OLD OR NEW 
question. 


Since the translator may replace a single Time-Sharing FORTRAN statement 
with one or more batch statements, the user should insure that his input 
file is line ordered and that his line numbering has an origin of ten or 
greater, with increments of at least 10. 


The translator uses FORTRAN statement numbers, or statement label 
numbers (not line numbers), of 32000 and subsequent for created format 
statements that replace quoted data in PRINT statements. Therefore, the 
user must replace any statement numbers in this range to avoid duplicate 
reference. 
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Following the response to OLD OR NEW -, the translator issues a series 
of questions which permit the user a number of program options: 


e Choose a BCD or ASCII save file, or both, as explained above. 


e Choose to have line numbers either stripped, moved to the label 
field (cols. 73-80) of the batch-statement card, or moved with a 
constant prefix. (Applies to the BCD save file only.) 


@e Choose to have a listing of the translation in progress. 


e Control the assignment of file codes, including a save, recall, 
and modification of a file code table. 


Detailed Usage 


The conversation between the system and the user, beginning with the 
selection of the translator, is as follows: 


SYSTEM ?TRANS 
OLD OR NEW-OLD filename 
BCD SAVE FILE NAME? {GHEE | 


carriage return 


If the user wishes a translation file in BCD form, for batch input, he 
specifies the name of a file, previously defined or not, upon which the 
translated program is to be saved. If he does not want a BCD save file, 
he simply responds with a carriage return, 


The following question is asked only if the user has responded filename 
to the question above: 


LABELS? MOVE or carriage return only 
STRIP 
apcde (i. .g5/9) Pe. - Boney 2. ys ees 


5-50 BSOL 


This question requests information about what is to be placed in the 
label field (columns 73-80) of the source statement on the BCD file. The 
meaning of the responses shown is as follows: 


MOVE or carriage return only -- move the line numbers found in the 
input file into the label field of the BCD file. 


STRIP -- ignore the line numbers and leave the BCD label field 
blank. 
abcde (i), jz)... -- move the line numbers to the label field 


prefixed by the specified alphanumeric characters. 

abcde - Alphanumeric label prefix. 

i - Starting line number. 

5 - Final line number to which this prefix is to be added. 
Multiple sequences of line numbers, with different prefixes can be 


specified. If an interval of line numbers is found that has not been 
specified by the user, only the line number is placed in the label 


field. 
Note that? abcde (15> 97) = abede: (774 2)) 
abcde (,j,]) = abcde (0, jj) 
abcde (ij,) = abcde (ij, 99...9) 


ASCII SAVE FILE NAME? filename 
carriage return 


If the user wishes to save a time-sharing version of his translation 
file so that it may be updated or modified from a terminal, he may 
designate a new or previously defined file upon which to save _ the 


translated data. A carriage return only indicates that an ASCII file is 
not desired. 


Note 
The user must designate either a BCD or an ASCII 


translation file, or both. If he fails to do so, the 
following message is issued: 


NO TRANSLATION FILE REQUESTED 


The user is returned to the SYSTEM? level. 
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LIST? YES or Y 
carriage return 


The user is asked if he wants an on-line listing of the translation 
while it is in progress. A carriage return indicates no listing is 
desired and only the fatal errors are printed at the terminal. If a 
listing is desired, the original Time-Sharing FORTRAN statement is 
printed, immediately followed by its translation. The translation may 
consist of a reproduction of the original statement, if no change is 
necessary, or of one or more substituted statement(s). 


COMMENT? ( 2 data } 
ee 
carriage return 


In order to allow the user to distinguish one translation from another, 
he is asked for a comment card (on a BCD file, it appears as a label 
preceding each page of his listing). A carriage return indicates that no 
comment is desired; otherwise, the user may type any data that he 
desires and it will be inserted as the first record in the BCD file or 
line number 8 of his ASCII translation file. 


FILE TABLE FILE? filename 
carriage return 


A major portion of the time-sharing to batch translation is the 
replacement of permanent time-sharing file names by numeric file codes. 
The translator builds a table of these associations, which the user may 
save on a permanent file from one execution of the translator to the 
next. In response to this query, the user may type the name of a 
file-table file previously generated by this subsystem. Refer to the 
SAVE FILE TABLE? question below. A carriage return indicates no previous 
file-table file for this program. 


MODIFY FILE TABLE? YES or Y 
carriage return 


The user is allowed to specify which file names in his time-sharing 
program are to be associated with particular file codes for this 
translation (whether or not he indicated a prior file-table file), as 
follows. 


The following pair of questions are conditional upon a YES or Y response 
to the question MODIFY FILE TABLE?. 
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FILE CODE? 1 through 43 
carriage return 


FILE NAME? filename 
carriage return 


If a positive response was given to the modification query, the user is 
asked to type the numeric file code and the file name referenced in the 
time-sharing program to be associated with it. The file code/file name 
questions are repeated until the user responds with a carriage return 
only to either question, If the user types an illegal file code, the 
subsystem issues the following message: 


INVALID FILE CODE (1 TO 43 ONLY) 


and repeat the file code question. When modifying a previously existing 
file-table entry gotten from a prior file-table file, the old file 
code/file name association must be either explicitly replaced or blanked 
out; otherwise duplication occurs. For example, if the prior file table 
contains the association: 


FILE CODE FILE NAME 
07 XYZ 


and the user wishes to switch the name XYZ to file code 10, he must 
respond as follows (user responses underlined): 


FILE CODE? 07 


NAME? carriage return 
FILE CODE? 10 


NAME? XYZ 


Otherwise, the file table appears as: 


FILE CODE FILE NAME 
07 XYZ 
10 XYZ 
LIST FILE TABLE? YES or Y 


carriage return 
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The user may choose to list the content of his file table which resulted 
from this execution, after the input file has been translated. A sample 
file table list is as follows: 


FILE CODE FILE NAME 
01 AFILNAM 
07 XFILE 
41 LASTFIL 
SAVE FILE TABLE? filename 
carriage return 


The user may save the content of the file table from this execution for 
a later execution of the translator. The named file may or may not be a 
previously defined permanent file. 


Fatal Errors During Translation 


Each Time-Sharing FORTRAN statement is examined to see if it is an 
acceptable batch statement. There are four possible results of this 
examination: 


e No data change -- statement is batch compatible. 

e A single translated statement. 

e Multiple translation statements. 

e A fatal error--no translation possible. In this case, the 


subsystem prints the fatal statement and issues the following 
message: 


FATAL ERROR, REPLACE BY: 


uhe user may type in a statement to replace the original. He 
should not reenter either the line number or formula number of 
the statement, but only the statement itself. The line number 
and formula number, if they existed, will be carried over from 
the original statement. 
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If the user does not wish to replace the statement, he may 


change it into a comment by giving a carriage 


return only in 


response to the message. Alternatively, if he does not want to 
replace the statement and wants it converted to BCD "as is," he 
may indicate this by responding with a pound sign and carriage 
return. This is useful where the target compiler may contain 


extended implementations; e.g., ENCODE/DECODE. 


Sample Translated Statements 


The following are sample translations: 


i 9 LOGICAL KKOO1] 


This statement is inserted into each translation to provide 


for EOF processing. 


2. 100 ASCII ABC,NAME,XYZ 
100 INTEGER ABC ,NAME ,XYZ 

3. 200 FILENAME FILE1,FILE2,FILE3,X 
200 INTEGER FILE1,FILE2,FILE3,X 


z~A IO 


All file name variables are saved ina table, so that if 


equated in a quoted expression, the appropr 
will be substituted. 


4. 300 X = "FILNAM" 
300 X = 07 


The file code substituted is the first ava 
one provided by a previous file table 
designated by the file table modification. 


Ss 400 BACKSPACE "FILNAM" 
400 BACKSPACE 07 

6. 500 ENDFILE "FILNAM" 
500 ENDFILE 07 

De 600 BEGINFILE "FILNAM" 
600 REWIND 07 


There may exist some differences in REWIND 
time-sharing and batch execution. 


ijate file code 


ilable one, or 
file, or one 


processing in 


BSOL1 


8. 700 CLOSEFILE "FILNAM" 


700 REWIND 07 
9. 800 CALL SUBR (A,B,"QUOTES" ,X,Y) 
800 CALL SUBR (A,B,6HQUOTES ,X,Y) 
10. 900 DATA ABC/"QUOTES"/ 


900 DATA ABC/6HQUOTES/ 


ll. 1000# 120 FORMAT (2F6.2,"QUOTES",E12.5) 
1000# 120 FORMAT (2F6.2,6HQUOTES,E12.5) 


12. 1200 IF (A.NOT.B) REWIND "FILNAM" 
1209 IF (A.NOT.B) 
1201 1REWIND 07 


13. 1300 PRINT:"QUOTED DATA" 
1300 PRINT 32000 
1301# 32000 FORMAT (12H QUOTED DATA) 


14. 1400 READ("FILNAM",150,END=500)A,B,C 
1400 CALL FLGEOF (07,KK001) 
1401 READ (07,150)A,B,C 
1402 IF (KK001) GO TO 500 


15. 1500 WRITE ("FILNAM",250)A,B,C 
1500 WRITE (07,250)A,B,C 


16. 1600 X=Y;PRINT: "DATA"; A=B 
1600 X=Y 
1601 PRINT 32001 
1602# 32001 FORMAT (5H DATA) 
1603 A=B 


Sample Non-Translatable Statements 


The following statements are flagged by the translator as fatal errors: 


Ps 100 A="QUOTES" where A has not been defined as a 
file name variable. 

2% 200 120 FORMAT (V) 

36 300 ENCODE (a,n) list 
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4. 400 DECODE (a,n) list 


5. 500 PRINT:A,B,C 

6. 600 PRINT:"QUOTED DATA" ,X,Y,Z 

7. 1700 READ:A,B,C 

8. 800 READ ("FILNAM"'100)A,B,C--random file processing 
9. 900 WRITE ("FILNAM"'5)A,B,C--random file processing 


The translator does not check the syntax of the input statements. Thus, 
the user should insure that his parentheses are balanced, expressions 
are not in mixed mode, etc. Translation terminates when either an EOF is 
found on the input file or an END statement has been encountered. 


TIME-SHARING FORTRAN LIBRARY GENERATOR/LIBRARY EDITOR 


The Time-Sharing FORTRAN Library Generator program and the Time-Sharing 
FORTRAN Library Editor subsystem, together, provide the capability to 
produce a load time library of Time-Sharing FORTRAN subroutines. Such 
libraries are collections of independent object subroutines either 
written in Time-Sharing FORTRAN or in GMAP language, the coding of the 
latter conforms to special Time-Sharing FORTRAN standards with respect 
to floatability and linkage conventions. 


The Library Generator produces the Time-Sharing FORTRAN loadable library 
file from one or more files of subroutines in GESAVE or General Loader 
format. 


The Library Editor allows the user to edit his file(s) of library 
subroutines in GESAVE format, prior to the use of the Library Generator 
program. The user can add, delete, replace, or copy individual 
subroutines on a master file. 


Library Generator Program 


The Time-Sharing FORTRAN Library Generator (TSLG) Program is a batch 
program that is distributed on the System Software Library. It may be 
called via a $ PROGRAM card. 
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TSLG permits a user to produce his own library file of Time-Sharing 
FORTRAN subroutines, complete with directory, in a form that is 
acceptable to the Time-Sharing FORTRAN loader. TSLG accepts collections 
of floatable subroutines, in one or both of the following formats: 


e GESAVE format, as produced by a loader activity (H* file) and 
saved on a random permanent file, or as produced by Time-Sharing 
FORTRAN compiler (savefile). 


e General Loader format, as produced by the Object Library Editor 
on a magnetic tape file. 


TSLG processes these subroutines so as to produce one or both of the 
following: 


e A random mass storage file to be used as an individual user's 
own Time-Sharing FORTRAN library, accessible by the Time-Sharing 
FORTRAN loader from the permanent file system, 


e A magnetic tape file (Q*) to be loaded at system startup time as 
the installation's standard Time-Sharing FORTRAN library. 


The user normally should not be concerned with the production of the 
latter. (TSLG may also be used by the installation for maintenance of 
the standard Time-Sharing FORTRAN subroutine library.) 


The user's own library is stored on a permanent file named by the user 
on one of his TSLG job $ PRMFL cards. At FORTRAN run time, he identifies 
this library to the subsystem via the ULIB option in the RUN command. 


SUBROUTINE CODING REQUIREMENTS 


Library routines may be coded in either Time-Sharing FORTRAN or _  GMAP. 
The individual library subroutines, when coded in GMAP language, must 
conform to Time-Sharing FORTRAN coding conventions; i.e., they must be 


compatible with the code produced by the Time-Sharing FORTRAN compiler. 
The conventions concern: 


e Special linkage (global reference) symbols, which replace the 
normal SYMREF/SYMDEF symbols. 


@e Floatable, or self-relative, coding -- all location references 
IC-modified. 


e Intra-subroutine communication, argument passing, etc. 
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The subroutines written in Time-Sharing FORTRAN language are compiled 
and saved on a permanent file, as are the GMAP assemblies. 
Compiler-saved output is automatically in GESAVE, or system loadable, 
format. 


Instructions for writing subroutines in GMAP to Time-Sharing FORTRAN 
standards, using special GMAP macros developed for this purpose, and on 
obtaining system loadable (GESAVE) format on a permanent file, are 
described in the Writing Subprograms in Assembly Language paragraph. 


INPUT AND OUTPUT FILES 


Figure 5-5 illustrates the files utilized by TSLG. Descriptions of the 
files follow. 


The principal inputs to TSLG, from the normal user's viewpoint, are as 
follows: 


@e UI, a disk (or drum in Series 600), permanent file of user's 
subroutines in GESAVE format. 


@e I*, a $ DATA file of control cards, on disk (or drum). 


Additional inputs are: 


e R*, a labeled magnetic tape file which contains the standard 
Time-Sharing FORTRAN library subroutines distributed with the 
system, in Loader object library format, as produced by the 
Source/Object Editor (a component of the System Editor). 


e *Z, a magnetic tape file identical in format to R*, containing 
installation-written subroutines additional to the standard 
subroutines on R*, or containing an edited selection of R*. 
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Figure 5-5. Files Used by Time-Sharing FORTRAN Library Generator 
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Each of the inputs described above are optional, except that the I* file 
(IN control card) must exist if either UI cs *Z (or both) exist, or if 
output file UO is to be produced (OUT control card). The user will not 
normally be concerned with the R* input or Q* output. The I* file is the 
file generally required. 


Two intermediate work files must be provided: 


e *l, a magnetic tape file. 


e *2, a temporary disk/drum file used for error messages, to be 
written subsequently on the output file P* (SYSOUT). 


The possible output files are: 


e UO, a disk/drum, permanent file containing the user's 
Time-Sharing FORTRAN library, accessible from the permanent file 
system by the FORTRAN loader. 


e P*, a SYSOUT file containing a library storage map and error 
messages. The map and messages are described below. 


e Q*, a labeled magnetic tape file containing the standard 
Time-Sharing FORTRAN library, to be loaded by the startup 
routine at system initialization time. 


Either UO or Q*, or both, may be produced. It is assumed herein that 
only the UO file is to be produced; therefore it must be specified on an 
OUT control card (I* file). P* must always be provided. 


The output file (Q*) is not rewound on open or close. All other magnetic 
tape files are rewound when opened. 


Either or both of the file codes, UI and UO, may be replaced by file 
codes of the user's choice, on his job control cards and on IN/OUT 
control cards. 


CONTROL CARD AND FILE USAGE 


Two control cards may appear on the I* ($ DATA) file -- an IN _ card 
and/or an OUT card. The IN card is used to specify which input file(s) 
-- of the set UI, *Z, and R* -- are to be processed and also, 
implicitly, the order in which they are to be processed. The OUT card is 
used simply to specify which output file(s) -- of the set UO, Q* -- are 
to be produced. 
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If no IN card is present, the presence of R* only is assumed by TSLG. If 
multiple IN cards are present, only the last one is acknowledged. If no 
OUT card is present, the presence of Q* only is assumed by MTSLG. rr 
multiple OUT cards are present, only the last one is acknowledged. 


If more than one input file is specified (e.g., UI and *2Z), the content 
of each input file is processed and written on the output file in the 
order in which the input file codes appear on the IN card. Thus, all 
routines on the input file corresponding to the first-specified file 
code will appear on the output file before those on the second input 
file, etc. 


In general, TSLG processes entire input files only. Selective editing of 
UI files may be performed with LIBED; selective editing of a *Z file may 
be performed during the required Object Library Editor processing. See 
the Source/Object Editor Reference Manual, for information pertaining to 
the Object Library Editor. 


Input from R* and/or *Z is normally used by the installation to produce 
a modified Time-Sharing FORTRAN library file, on Q*, Input from UI is 
normally used to produce a user's Time-Sharing FORTRAN library file, on 
UO. However, subroutines from any of the possible input files, or any 
combination thereof in any order, can be written to UO (or Q*). 


The essential differences between the two libraries are that the 
Standard library, on Q*, is initialized as a permanent file by the 
Startup routine at a subsequent system-startup time, and is 
automatically searched by the Time-Sharing FORTRAN loader if no user's 
library (ULIB) is specified at FORTRAN run time. If one or more ULIB's 
are specified, the loader searches the standard library last in 
attempting to satisfy any subroutine calls still outstanding. Thus, the 
standard library is referenced implicitly, and a user's library is 
referenced explicitly, with the latter having priority. 


Control Card Formats 


The control field of the IN/OUT control cards starts in column 8, and 
the variable field starts in column 16; multiple file codes are comma 
separated. 
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e IN Control Card 


B 8 16 
IN £Cy,) £Co%. £63 
Where fc is one of the set (UI, *Z, R*), normally only UI. File 


code UI may be replaced by a code of the user's choice. At least 
one file code must appear. 


e OUT Control Card 


1 8 16 


OUT f¢e417,-£¢2 


Where fc is one of the set (UO, Q*), normally UO. File code UO 
may be replaced by a code of the user's choice. At least one 
file code must appear. 


Any card type other than IN or OUT, as defined above, appearing on I* 
causes TSLG to be aborted. 


PROGRAM DESCRIPTION 


The following general deck setup illustrates a user's execution of TSLG. 
It is assumed that UI and UO are permanent files previously created 
(e.g., via the ACCESS subsystem) and that the user specified on the $ 
USERID card has permission to read UI and to write UO. 


$ SNUMB 
$ IDENT 
$ USERID user-idSpassword 
$ PROGRAM TSLG 
$ LIMITS 30,32K,0,5000 
$ TAPEL *Z,X1D 
$ PRMFL UI,R,R,catalog$password/filename 
$ PRMFL UO,W,R,catalog$password/filename 
$ TAPE *1,X2R 
iS FILE *2,X3R,1R 
$ SYSOUT p* 
S DATA I* 
IN2 UL. (or UL, *Z-.or *Z UT) 
OUT UO 
$ ENDJOB 


linclude only if applicable. 
Variable field specified as applicable. 
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STORAGE MAP AND ERROR MESSAGES 


The FORTRAN library storage map is printed by the SYSOUT Report Writer. 
It contains the following information for each routine in the library: 


e The sector address at which the routine is stored. 


e The identification (name) of each SYMDEF/.SDEF. in the routine 
and an indication of its type (primary or secondary). 


e The sector address contained in the directory entry 
corresponding to each SYMDEF/.SDEF.. (This address appears only 
if it differs from that of the current routine.) 


e The identification and corresponding sector address of 
SYMDEF/.SDEF. referred to by each .SREF.. (Undefined .SREF.'s 
are flagged with a U.) 


Appended to the storage map are any applicable error or warning 
messages, as follows: 


PROGRAM identity ABORTED FOR INSUFFICIENT 
BUFFER SPACE. 


RERUN WITH MORE CORE SPECIFIED ON $ LIMITS CARD. 
SYMDEF'S DEFINED IN WRONG ORDER: 
SYMREF'S UNDEFINED: 


NO OBJECT CARD BEFORE card type CARD card identity 
DECK BYPASSED, PREVIOUS COMPLETE DECK 


identity of previous deck. 


NO DKEND CARD IN DECK identity of current deck 
DECK BYPASSED PREVIOUS COMPLETE DECK 


identity of previous deck. 
card type CARD card identity OUT OF ORDER IN DECK 
ldentity of current deck. 


NO TEXT CARDS IN DECK identity of current deck 
DECK BYPASSED. PREVIOUS COMPLETE DECK 


identity of previous deck. 


card type CARD card identity IN DECK 
1dentity of current deck. 
DECK BYPASSED. PREVIOUS COMPLETE DECK 


identity of previous deck 
something wrong with the card) 
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10. NONZERO RELOCATION BITS IN card type 
CARD card identity 


DECK BYPASSED. 


PREVIOUS COMPLETE DECK 


identity of previous deck. 


11. CHECKSUM ERROR IGNORED IN card type 
CARD card identity. 


12. OCTAL CARD FORMAT ERROR IN DECK 
identity of current deck 


DECK BYPASSED. 


PREVIOUS COMPLETE DECK 


identity of previous deck 


13. CHECKSUM ERROR IGNORED IN WORD O OF CONTROL BLOCK 
FOR ROUTINE routine. 


PROGRAM ABORTS 


Execution of TSLG may be aborted for the following reasons: 


Reason Code 


0 


Meaning 


Specified input or output file not present. 
Premature EOF on input file R* or *Z. 


Wrong routine read from *l. 


Previously defined SYMNDEF not found in directory. 


Premature EOF on *S, 


Insufficient buffer area provided. (Rerun 
larger core specification on $ LIMITS card.) 


Invalid device code specified in file control 
for UI or UO. 


Name of routine in UI control block does not 
with name in catalog. 


with 


block 


agree 


Number of sectors specified in UI control block is 


inconsistent with total DCW word count. 


Invalid control card in I*. 
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Library Editor Subsystem 


The Time-Sharing FORTRAN Library Editor (LIBED) is a time-sharing 
subsystem that may be called at the subsystem selection level (SYSTEM?) 
by the name LIBED. It allows the user to manipulate collections of 
independent subroutines or subprograms stored on permanent files in 
GESAVE (H*) format. The user can combine several collections into one 
file, to delete elements from such a collection, or to extract (copy) 
selected elements. 


LIBED is specifically intended for the editing of subroutine library 
files. These files are to be subsequently processed by the Library 
Generator (TSLG) program. However, the LIBED functions are equally 
applicable to any collection of object programs, subprograms, or 
subroutines in GESAVE format. 


The LIBED subsystem provides for three processing functions -- LIST, 
APPEND, and DELETE -- and utilizes the control command DONE. The 
subsystem operates on any of the following combinations of files: 


e Old master file (only) 
e@e Old master file and update file 
e Old master file and new master file 


e Old master file, update file, and new master file. 


‘Each of these files must be previously created permanent files, and must 
be accessed explicitly prior to the use of LIBED. 


A convenient means of pre-accessing these files is by the GET command, 
which may be given at the subsystem selection level. The old master and 
update files must be random files in GESAVE format. The new master must 
be defined (or accessed) as a random file. The new master file may be a 
newly created, empty file (created most conveniently via the ACCESS 
subsystem), or it may contain previously stored data which will be 
overwritten. 


If all three files are specified, processing results in a modified new 
master file, and neither the old master file nor the update file is 
changed. If a new master file is not specified, all modifications take 
place on the old master file. 
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USE OF LIBRARY EDITOR 


Following selection of LIBED, at the subsystem selection level, 
is asked the question: 


FILES? 
Possible user responses to this question are as follows: 


e old-master-name 


@e old-master-name, update-name 


e old-master-name, new-master-name 


@e old-master-name, update-name, new-master-name 


Having received a valid reply to the FILES? question, the 


the user 


subsystem 


responds with the message READY. In response to READY, the terminal user 


may type in one of the following commands: 


e LIST filename 


The filename is the name of one of files specified in 
to the FILES? question. 


response 


The subsystem lists the names of all routines on the designated 
file along with the number of blocks required to contain each 
routine. The list terminates with a report of the total number 


of blocks used on that file. 


Example of LIST format: 


LIST OLDMAS 


ROUTINE NAME NO. OF BLOCKS 
XROUTN 5 
YROUTN 7 
ZROUTN 6 
TOTAL NO. OF BLOCKS USED 18 
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@ APPEND subr 1, subr 2,...,subr n 


The subr i is the name of a routine on the update file to be 
appended to the old master file to generate either a modified 
old master file or a new master file. When no routine name is 
supplied, the entire contents of the update file is appended as 
above. 


e DELETE subr 1, subr 2,....,sSubr n 


The subr iis the name of a routine to be deleted from _ the 
current master file (old master file, if no new file is 
designated, or new master file, if it were created prior to this 
command). If DELETE is given with a nonexistent routine name 
specified, a copy of old-master to new-master takes place. 


e@ DONE 


This command terminates the subsystem, releases all files 
involved, and returns control to the subsystem-selection level. 


EXAMPLE OF COMBINED LIBED AND TSLG USAGE 


Time-Sharing FORTRAN subroutines to be used as input to LIBED 
(optional), and then to TSLG, may be written originally in Time-Sharing 
FORTRAN and compiled or may be written in GMAP (observing special coding 
restrictions). Therefore, hypothetical Time-Sharing FORTRAN generated 
subroutines are used for the purpose of the following example. Text 
within brackets is not part of the printout, but is added to explain 
features of the program. 
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1. To create user library subroutines via Time-Sharing FORTRAN: 


SYSTEM ?ACCESS --- (Subsystem selection to create file 
space) 
FUNCTION? CF 
CATALOG STRUCTURE TO WORKING LEVEL? 


FILE NAME,SIZE(IN BLCKS) ,MAX SIZE? Al,3,3,R 
PASSWORD? 
GENERAL PERMISSIONS? 
SPECIFIC PERMISSION? 
LOGICAL RECORD SIZE? 
SUCCESSFUL! 
FILE NAME,SIZE(IN BLCKS) ,MAX SIZE? A2,2,3,R 
PASSWORD? 
GENERAL PERMISSIONS? 
SPECIFIC PERMISSION? 
LOGICAL RECORD SIZE? 
SUCCESSFUL! 
FILE NAME,SIZE(IN BLCKS) ,MAX SIZE? A3,6,6,R 
PASSWORD? 
GENERAL PERMISSIONS? 
SPECIFIC PERMISSION? 
LOGICAL RECORD SIZE? 
FILE NAME,SIZE(IN BLCKS) ,MAX SIZE? 


SUCCESSFUL: 

FUNCTION? 

SYSTEM ?FORTRAN --- (Subsystem selection to create 
OLD OR NEW-NEW subroutines QUAD and NTRS) 
READY 


*010 SUBROUTINE QUAD (X,Y,2Z) 

*020 READ:A,B,C 

*030 RR=B**2-4.0*A*C 

*040 DD=SORT (RR) 

*050 X1l=(-B+DD)/2.0*A 

*060 X2=(-B-DD) /2.0*A 

*070 PRINT:X1,X2 

*080 RETURN 

*090 END 

*100 SUBROUTINE NTRS 

*110 X=1.0 

*120 2EX=EXP (X) 

*130 EMX=1.0/EX 

*140 XNEW=X+ ( (EX+EMX) /2.0+COS (X)-3.0) / ( (EX-EMX) /2.0-SIN (X) ) 
*150 PRINT:XNEW 

*160 IF (ABS(X-XNEW) .LT. 1.E-6) STOP 
*170 XNEW=X 

*180 GO TO 2 


*190 END 
*RUN =A1(NOGO) --- (Place QUAD and NTRS in file Al) 
*NEW --- (Create Subroutine FACT and AREA) 
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READY 

*010 SUBROUTINE FACT (K,J,N) 

*020 READ:K,J,N 

*030 PRINT 88,K 

*040 88FORMAT(1HO,1I5," FACTORIAL IS") 
*050 DO 99 I=1,N 

*060 J=J-1 

*070 K=K*J 

*080 99CONTINUE 

*090 PRINT:K 

*100 RETURN 

*110 END 

*120 SUBROUTINE AREA (X,Y,2Z) 

*130 READ:A,B,C 

*140 S=(A+B+C) /2.0 

*150 AREA=SQRT(S* (S—A) * (S-B) * (S-C) ) 
*160 PRINT:A,B,C,AREA 

*170 RETURN 


*180 END 
*RUN =A2(NOGO) --- (Place FACT AND AREA in file A2) 
* DONE 


2. To merge subroutines on files Al and A2 onto file A3: 


SYSTEM ?ACCESS --- (Subsystem selection to determine 
permissions) 


FUNCTION? AF 
CATALOG STRUCTURE TO WORKING LEVEL? 


FILE NAMESPASSWORD? Al 

PERMISSIONS DESIRED? R,W 
SUCCESSFUL! 

FILE NAMESPASSWORD? A2 

PERMISSIONS DESIRED? R,W 
SUCCESSFUL! 

FILE NAMESPASSWORD? A3 

PERMISSIONS DESIRED? R,W 
SUCCESSFUL: 

FILE NAMESPASSWORD? 


SYSTEM ?LIBED --- (Subsystem selection to edit files) 
FILES? A1,A2,A3 --- (old-master-name,update-name, 
READY new-master-name) 
LIST Al 
ROUTINE NAME # BLOCKS --- (Blocks refers to device block 
QUAD 0003 size) 
NTRS 0004 


TOTAL ¢ OF BLKS 0007 
# BLKS AVAIL. 0006 


READY 
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LIST A2 
ROUTINE NAME # BLOCKS 


FACT 0003 
AREA 0003 


TOTAL # OF BLKS 0006 


READY 
LIST A3 
NO DATA ON NEW FILE 
READY 
APPEND FACT --- (Append FACT from A2 to Al and create 
data for A3) 
READY 
LIST A3 
ROUTINE NAME # BLOCKS 
QUAD 0003 
NTRS 0004 
FACT 0003 
TOTAL # OF BLKS 0010 
# BLKS AVAIL. 0018 
READY 
DONE 


The file A3 now contains all the routines that the user desires 
to be on his own library, when it is created. File A3 can now 
be processed by TSLG, creating another permanent file in actual 
subroutine library format. 


To convert file A3 into a user's’ subroutine library the 
following deck setup may be used: 


$ SNUMB eee 
S$ IDENT eer 
$ FILEDIT OBJECT, INITIALIZE 
$ TAPE R*,X1S 
$ DATA *C,,COPY 
$ ENDCOPY 
S$ PROGRAM TSLG 
$ USERID user-id$password 
$ LIMITS 30,32K,0,10000 
S$ PRMFL UL,R,R,catalog/A3 
S$ PRMFL UO,W,R,catalog/A4 
$ TAPE *Z,X1R 
$ TAPE *1,X2R 
$ FILE *2,X3R,1R 
$ SYSOUT p* 
S$ DATA I* 
IN UL, ¥*Z 
OUT vO 
$ ENDJOB 
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A4 can now be specified as a user's library with the Time-Sharing 
FORTRAN RUN command; e.g.: 


*RUN =(ULIB)A4 
ERROR MESSAGES 
Possible error messages are as follows: 


NO OLD FILE NAMED 


User did not designate an old master file name. Control is returned 
to the subsystem selection level. 


FILE NOT RETRIEVED 


One of files specified by the user has not been placed in the AFT 
table. 


ILLEGAL COMMAND 


Response to READY was not a valid command, 


INVALID FILE NAMED 


User designated a file that was not previously defined for the 
subsystem, 


NO DATA ON NEW FILE 


User requested a list of the new master file which had not been 
created yet in this subsystem. 


ROUTINE xxxxxx NOT FOUND 

In use of the DELETE or APPEND command, the user designated a 
routine name that could not be found on the appropriate file. 

NO MORE ROOM ON CURRENT MASTER 

The new master file (or the old master file if no new file was 


specified) has no more disk/drum space. Current master contains all 
information up to the point where this condition was found, 


NO UPDATE FILE NAMED 


The APPEND command was issued but no update file was specified. 
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DISK/DRUM ERROR 


An unrecoverable error occurred while reading or writing subsystem 
files. 


FILE IS NOT A RANDOM FILE 


One of the files designated by the user is not a random file. 


SYSTEM ERROR 


Invalid condition occurred within subsystem. 


FILE TOO LARGE FOR SUBSYSTEM 


Table overflow in subsystem. The subsystem can handle a file of 320 
links, with 180 routines on it, if the block size is 64 words. With 
a block size of 40 words, a file of 216 links containing 108 
routines is the maximum. 
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